ae_douyin_index_fetch_insight_recommend
Retrieve the trend insight reports recommended on the Douyin Index home page. No input parameters are required. Results provide a recommended report list with metadata such as report IDs, titles, cover images, and publication times, where available. This is a recommendation list, not the full content of each report; exact fields depend on the returned data.
ae_douyin_index_fetch_item_analysis
Retrieve comparison analysis for a Douyin video over a specified date range to understand its performance relative to similar videos or broader benchmarks.
Required inputs:
- item_id: The Douyin video (aweme) ID, supplied as a string containing only digits.
- start_date: The start date as a YYYYMMDD string.
- end_date: The end date as a YYYYMMDD string.
The response contains comparison results in data, which may be null. The available schema does not specify individual metrics or comparison dimensions; use the fields actually returned.
Example inputs: item_id="7660090930283744575", start_date="20260704", end_date="20260710".
ae_douyin_index_fetch_item_index
Retrieve index trends for a specified Douyin video over a date range.
Required inputs:
- item_id: The video's numeric Douyin aweme ID, supplied as a string.
- start_date: Start date as a YYYYMMDD string.
- end_date: End date as a YYYYMMDD string.
The result provides video index trends over the requested period, potentially including composite, spread, and interaction indices. Available metrics and time points depend on the returned data; the detailed data structure is not specified. Index values should not be interpreted as raw view or interaction counts.
ae_douyin_index_fetch_item_index_interpret
Retrieve index interpretations for a Douyin video over a chosen date range, including explanations and attribution for composite, spread, interaction, and other sub-indices.
Required inputs:
- item_id: The video's Douyin aweme ID, supplied as a numeric string.
- start_date: Start date as a YYYYMMDD string.
- end_date: End date as a YYYYMMDD string.
The response data provides the index interpretation. Its detailed fields are not specified, so individual sub-index fields or numerical scores are not guaranteed. Use alongside a video index query when you also need the underlying index values.
ae_douyin_index_fetch_report_detail
Retrieve the full details of a trend insight report.
Input: report_id is a required string, such as "1081". Use a report ID from report search or insight recommendation results.
Returns: report data that may include the title (title), cover image (cover), publication time (publish_time), associated product or business tags (business), body content (content), image assets (images), and PDF download link (pdf_url). Available fields depend on the returned report; data may be null.
Use this tool to read a specific report or obtain its asset links. It does not search for reports or download the PDF file.
ae_douyin_index_fetch_valid_date_for_relation
Get the available date range for Douyin Index relation analysis.
Inputs: None.
Returns: The start and end dates available for relation analysis. Use these dates to guide the choice of an analysis period. This tool does not return relation analysis results; date field names and formats are not specified in the source documentation.
ae_douyin_search_fetch_school_search
## Purpose
Search for school names available in Douyin using a school-name or location keyword, for example when finding a school to select in a profile.
## Input
- `request_body` (required object): Contains the search input.
- `request_body.keyword` (optional string): A school name or location, such as `北京大学` or `北京`. The schema default is `北京`.
Example:
```json
{"request_body":{"keyword":"北京大学"}}
```
## Return value
The response includes a `code` status field and a `data` payload. Documented search content includes a `schools` list whose entries contain `name`, along with `status_code` (`0` means success) and `status_msg`. Additional metadata may include timestamps and request-tracing identifiers. The `data` schema is open-ended and permits null; inspect the actual response for available fields.
## Limitations
This tool searches school names, not videos, accounts, or detailed school profiles. It does not expose a cursor or other pagination input. Search matches are not verified institutional records.
ae_douyin_xingtu_author_content_hot_comment_keywords_v1
Retrieve hot-comment keyword analysis (V1) for a Douyin Xingtu creator.
Input: kolId is required and must be supplied as a string containing the creator's Xingtu KOL identifier, for example "7048929565493690398". If you only have a UID, sec_user_id, or unique_id, first obtain the corresponding kolId through an identifier lookup.
Returns: the creator's hot-keyword analysis in the response data. The detailed data structure is not specified; keyword counts, rankings, scores, time coverage, and individual comment text are not guaranteed.
ae_douyin_xingtu_author_hot_comment_tokens_v1
Retrieve comment hot-word analysis for a Douyin Xingtu creator.
Input: kolId is required and must be a string containing the creator's KOL identifier, for example "7048929565493690398". If you only have a UID, sec_user_id, or username, first obtain the corresponding kolId.
Result: Returns comment hot-word analysis in data, along with response status information. The detailed analysis fields are not specified, and data may be null. Do not treat the result as a documented list of individual comments.
ae_douyin_xingtu_get_author_audience_distribution
## Purpose
Retrieve a creator's audience profile distribution for a specified audience profile type.
## Inputs
- `o_author_id` (string, required): Creator ID.
- `link_type` (integer, required): Audience profile type code. `5` is a documented example; the meanings of individual type codes are not specified. This parameter must be supplied to obtain valid profile data.
- `platform_source` (integer, optional): Platform source; defaults to `1`.
- `platform_channel` (integer, optional): Platform channel; defaults to `1`.
## Result
Returns a response with audience distribution data in `data`, which may be null. The detailed distribution fields are not specified in the available definition. Response metadata includes a status code and response messages.
## Example
```json
{"o_author_id":"7112600044674482187","link_type":5}
```
ae_douyin_xingtu_get_author_link_info
## Purpose
Retrieve a Douyin creator's Xingtu link indices: cooperation, CP, conversion, and shopping.
## Inputs
- `o_author_id` (required string): Creator ID, for example `"7589271892177518598"`.
- `platform_source` (optional integer, default `1`): Platform source.
- `platform_channel` (optional integer, default `1`): Platform channel.
- `industy_tag` (optional integer, default `0`): Industry tag; `0` means no industry restriction. Use this exact parameter spelling.
## Result
The response's `data` carries the available link-index information: `cooperate_index` (cooperation), `cp_index` (CP), `link_convert_index` (conversion), and `link_shopping_index` (shopping). `data` may be null. The detailed data layout, index scales, and scoring methodology are not specified, so these indices should not be interpreted as raw transaction counts or conversion rates.
ae_douyin_xingtu_get_author_local_info
## Purpose
Retrieve location information for a specified creator.
## Inputs
- `o_author_id` (required string): Creator ID, for example `"7146074596666507300"`.
- `platform_source` (optional integer, default `1`): Platform source selector.
- `platform_channel` (optional integer, default `1`): Platform channel selector.
- `time_range` (optional integer, default `30`): Time range in days.
The documentation does not define additional supported platform selector values or time-range limits.
## Result
Returns a response with creator location information in `data`, along with status and message metadata. `data` may be null, and its detailed structure is not specified. Particular location fields, geographic precision, and real-time positioning are not guaranteed.
ae_douyin_xingtu_get_author_market_fields
## Purpose
Retrieve all filter field options for the Douyin Xingtu creator marketplace, for use when selecting search criteria or displaying filter controls.
## Input
- `market_scene` (optional integer): Market scene. Defaults to `1`, the default scene. Other scene values are not documented.
## Result
Returns marketplace filter field information in the response data. The detailed data structure is not specified. This is filter option information, not a list of matching creators or creator profiles.
## Example
`{"market_scene": 1}`
ae_douyin_xingtu_get_author_show_items
Retrieve a creator's video list by creator ID.
Inputs:
- o_author_id: Required string identifying the creator.
- platform_source: Optional integer platform-source setting; default 1.
- platform_channel: Optional integer platform-channel setting; default 1.
- only_assign: Optional boolean; default false. Set to true to request only assigned videos. This filter applies only to Xingtu videos.
- flow_type: Optional integer flow-type setting; default 0.
The meanings of alternative source, channel, and flow-type values are not specified. Keep the defaults unless you know the appropriate settings.
Returns a response object with creator video list data in data, which may be null. The individual video fields and nested result structure are not specified; the result is not a guarantee of a complete video history or downloadable video files.
ae_douyin_xingtu_get_author_spread_videos
Retrieve representative videos that help assess a creator's content-spread performance.
Inputs:
- o_author_id (required string): Creator ID.
- platform_source (optional integer, default 1): Platform source; 1 means Douyin.
- platform_channel (optional integer, default 1): Platform channel; 1 means short video.
Returns: Creator spread-video data in the response's data field. The detailed video fields and performance metrics are not specified in the documented response schema.
ae_douyin_xingtu_get_content_trend_guide
Retrieves content trend guide data for reference.
- Input: No parameters; submit an empty object. No Cookie is required.
- Result: A JSON response with the guide payload in the data field, which may be null. The guide's internal fields are not specified.
- Scope: Reads a static JSON resource. No filtering or date-range selection is available, and a real-time update cadence is not specified.