ae_douyin_billboard_fetch_hot_total_hot_word_detail_list
Retrieve details for a content word on Douyin's hot list.
Required inputs:
- keyword: Search keyword, as a string.
- word_id: Content-word ID, as a string.
- query_day: Today's date, as an integer in YYYYMMDD format. Historical dates are not supported by the documented input requirement.
The response includes content-word details in data, along with response status and metadata. The data payload may be null, and its detailed fields are not specified.
ae_douyin_billboard_fetch_hot_user_portrait_list
Retrieve the audience profile of people who liked a specified work.
Inputs:
- aweme_id (required, string): The work ID.
- option (optional, integer): Select the profile dimension: 1 = mobile phone price distribution; 2 = gender distribution; 3 = age distribution; 4 = province distribution; 5 = city distribution; 6 = city tier; 7 = mobile phone brand distribution. Defaults to 4 (province distribution).
Returns: Response data describing the liking audience for the selected dimension. The detailed data structure is not specified. This profile concerns people who liked the work, rather than all viewers.
ae_douyin_creator_fetch_creator_activity_detail
Retrieve details for a specific Douyin creator activity.
Input: activity_id (required string), the activity ID obtained from the activity list. Example: "7545335931785450534".
Result: a response containing the activity detail data in data, which may be null. The documented response does not define the individual detail fields. Use this tool when you already have an activity ID; it does not list activities.
ae_douyin_creator_fetch_creator_activity_list
## Purpose
Retrieve Douyin creator activity list data for a time range.
## Inputs
- `start_time` (required integer): Start timestamp.
- `end_time` (required integer): End timestamp.
Timestamp units, time zone, and whether the boundaries are inclusive are not specified in the available documentation.
## Result
Returns a response containing creator activity list data in `data`, along with response status and metadata. `data` may be null; individual activity fields are not defined by the available response schema.
## Example
`{"start_time":1756656000,"end_time":1759247999}`
ae_douyin_creator_fetch_creator_content_category
Retrieve the content creation collection category list from the Douyin creator platform.
Inputs: No parameters are required; use an empty object ({}).
Returns: Collection category information in the response data. The structure of individual category items is not specified. This tool looks up categories; it does not retrieve a collection's contents or create or modify collections.
ae_douyin_creator_fetch_creator_hot_props_billboard
## Purpose
Retrieve the Douyin creator hot props billboard for discovering popular props by category, ranking metric, and time window.
## Inputs
All three inputs are optional integers.
- `billboard_tag` (default `0`): category ID; `0` means all categories. Documented IDs: `333` Food, `334` Travel, `299` Lifestyle, `335` Automotive, `336` Technology, `302` Gaming, `296` Anime, `337` Entertainment, `311` Celebrity, `298` Sports, `300` Culture & Education, `301` Campus, `297` Government, `305` Fashion, `306` Talent Show, `669` Finance, `314` Random, `307` Animals & Plants, `309` Graphics & Text, `308` Drama, `315` Parenting, `718` Agriculture, `310` Creative, `312` Outdoor, `926` Public Welfare. Additional category IDs require confirmation from category configuration; do not guess them.
- `order_key` (default `1`): `1` highest views, `5` most submissions, `6` highest exposure, `7` most favorites.
- `time_filter` (default `1`): `1` 24 hours, `2` 7 days, `3` 30 days.
## Result
Returns hot props billboard data for the selected filters and ordering. The response's `data` holds the result and may be null; individual ranking-item fields are not specified. This is a props billboard, not a creator or video ranking.
## Example
`{"billboard_tag":0,"order_key":1,"time_filter":1}` requests all categories ranked by highest views over 24 hours.
ae_douyin_fetch_creator_live_room_history_list
## Purpose
Retrieve live-session history for the Douyin creator account associated with a valid Douyin Creator Platform cookie. Use the records to review sessions and compare audience, engagement and consumption metrics across a date range. Ongoing sessions can optionally be included.
## Inputs
Provide a required `request_body` object containing:
- `cookie` (required string): a valid Creator Platform cookie for the account you are authorized to access. Treat it as sensitive account information.
- `start_date` and `end_date` (required strings): date boundaries in `YYYY-MM-DD` format.
- `limit` (optional integer): record limit, default 400; documented maximum 400.
- `need_living` (optional integer): `0` excludes ongoing sessions; `1` includes them. Default: `1`.
- `download` (optional integer): `0` disables downloading; `1` enables it. Default: `0`. A separate download response format is not documented.
## Results
The documented session list is at `data.data.series`. Each session may contain:
- Basic details: `roomID` (room ID), `roomTitle` (title), `coverUri` (cover image URL), `startTime` and `endTime` (timestamps formatted as `YYYY-MM-DD HH:mm:ss`), `liveDurationWithoutPause` (duration excluding pauses), and `playStatus` (`4` means ended).
- Audience metrics: `watchCnt` (total views), `serverWatchUcntTdDirect` (direct viewing users), `pcu` (peak concurrent viewers), and `liveServerWatchDurationTdPavg` (average watch duration).
- Engagement: `serverLikeCntTd` (likes), `clientCommentUcntTd` (commenting users), and `liveNewFollowUcnt` (new followers).
- Consumption: `liveConsumeUcnt` (consuming users), `liveFansConsumeUcntTd` (fan consuming users), and `roomLiveEarnScore` (earnings score, not a currency amount).
Metric values are shown as strings in the documented example. The unit of average watch duration is not specified.
## Limits and freshness
At most 400 records are returned per request, so a response need not cover every session in a large date range. The documentation recommends ranges of no more than three months and notes possible data delays of 1–2 hours. An expired cookie can prevent retrieval; including ongoing sessions does not guarantee real-time metrics.
ae_douyin_fetch_game_aweme
Retrieve a page of game-related video posts from Douyin.
Inputs:
- count (required integer): requested number of items per page; 16 is an example, not an automatic default.
- refresh_index (optional integer): paging index, default 1.
- cookie (optional string): your own Douyin Cookie. Providing it is recommended, as pagination may otherwise return duplicate items.
Returns: a response containing game-video data in data, plus status and response metadata. The data field may be null, and the schema does not define the individual video fields. Duplicate-free pagination is not guaranteed.
ae_douyin_fetch_industry_category_config
Retrieve the industry category configuration for the Douyin Creator platform to help choose industry filters for commercial mission tasks.
Input: No parameters are required; use an empty object ({}).
Result: The category data includes industry_categories (primary industries) and industry_subcategories (secondary industries grouped by primary industry ID). Each entry provides key (category ID) and label (category name); key "-1" means All. Use the returned IDs and relationships when configuring a separate task-list query. This tool returns category configuration, not task listings, and does not filter by industry.
ae_douyin_fetch_item_audience_portrait
## Purpose
Retrieve the aggregate audience profile for a specific Douyin item to support content planning and audience analysis.
## Required inputs
Provide a `request_body` object with both string fields:
- `cookie`: A valid Douyin Creator Platform Cookie. This is a sensitive session credential; handle it confidentially.
- `item_id`: The ID of the item to analyze.
## Result meaning
The response contains audience statistics in `data` when available:
- `active`: Activity-period shares. Keys `2`, `3`, `4`, and `-1` mean morning, afternoon, evening, and other/unclassified periods respectively.
- `gender`, `province`, and `age`: Audience composition by gender, province, and age group. `ratio_list` contains group shares as fractions from 0 to 1, while `tgi_list` contains Target Group Index values. TGI of 100 matches the platform average; above or below 100 indicates higher or lower representation relative to that average.
- `career`, `city_level`, and `new_user`: Additional career, city-level, and new-user dimensions, which may be empty.
This is a direct data query, not a background task. Check response status and data availability before drawing conclusions. Some dimensions may be empty or zero because of limited samples or unavailable statistics, and updates may be delayed. Results describe aggregate viewers of the selected item, not individual viewers or the account's overall followers.
ae_douyin_fetch_live_im_fetch
Retrieve danmaku parameters for a Douyin live room.
Inputs:
- room_id (required string): The live room ID.
- user_unique_id (required string): The user unique ID.
Returns a response with the danmaku parameter data in data, along with response status information. The detailed parameter-data structure is not specified. This is a parameter lookup, not a live chat stream or chat-history retrieval tool.
ae_douyin_fetch_music_aweme
Retrieve music-related video data from Douyin.
Inputs:
- count (required integer): Number of items per page. For example, use 16; this parameter must be supplied explicitly.
- refresh_index (optional integer): Paging index, defaulting to 1.
- cookie (optional string): Your Douyin Cookie. Using your own Cookie is recommended, as paging may otherwise return duplicate data.
Returns a response containing music-related video data in data, which may be null. Individual video fields are not specified in the documented response schema. No music ID or search query input is exposed, so this tool does not provide explicit selection of a particular track.
ae_douyin_fetch_query_user
Retrieve basic Douyin user information using a ttwid Cookie.
Input: request_body is a string containing the Cookie, such as "ttwid=xxx;". It is optional and has a preset default; provide your Cookie explicitly when you want to use a specific value. No user ID or search keyword is accepted.
Result: a response containing status information and a data field for user information. The data field may be null, and the available profile fields are not specified. Check the returned status and data before interpreting the result.
ae_douyin_fetch_series_detail
Retrieve details for a short-drama series by its ID.
Input: series_id (required string), the series identifier; for example, "7592054624643713067".
Returns: series detail data that may include the title, description, cover image, author information, total episode count, update status, play and favorite counts, and payment information when applicable. Available fields depend on the returned data; the detail structure is not fixed.
Use this tool when you already know the series ID. It does not search by title or download videos.
ae_douyin_fetch_user_fans_list
Retrieve a Douyin user's followers list in pages.
Inputs:
- sec_user_id: The target user's identifier. Supply the intended user's value rather than relying on the example default.
- max_time: Pagination timestamp as a string; default "0". Use the value returned by the previous response for later requests.
- count: Requested number of followers; default 20, which is recommended to keep unchanged.
- source_type: Request source type; default 1, but the first request must explicitly use 2.
Request sequence:
1. Initialize with max_time="0" and source_type=2. This returns an empty followers list together with max_time.
2. Use the returned max_time and source_type=1 to retrieve followers.
3. For further pages, use the latest returned max_time and keep source_type=1.
The result contains the followers list and pagination information. The initial empty list does not mean the user has no followers. Not following the initialization and pagination sequence may cause duplicate entries. The detailed fields for each follower are not specified in the available response schema.
ae_douyin_fetch_user_following_list
## Purpose
Retrieve accounts that a specified Douyin user follows, with timestamp-based pagination. This returns the user's following list, not their followers.
## Inputs
- `sec_user_id` (string): The target user's sec_user_id; supply the identifier of the user you want to query.
- `max_time` (string, default `"0"`): Pagination timestamp. Use `"0"` for initialization, then the value returned by the preceding request.
- `count` (integer, default `20`): Requested number of entries. Keeping the default is recommended.
- `source_type` (integer, default `1`): Use `2` for initialization and `1` for subsequent requests.
## Request sequence and results
1. Initialize with `max_time="0"` and `source_type=2`. This returns an empty list and a `max_time` value; the empty initialization list does not establish that the user follows no accounts.
2. Request list data with the returned `max_time` and `source_type=1`. For later pages, continue passing the preceding response's `max_time`.
Results contain following-list data and pagination information. Individual account fields are not specified in the available response schema. Skipping the initialization sequence may produce duplicate entries.