Douyin Index Fetch Relation Word
Retrieve words associated with a keyword on Douyin or Toutiao for a specified date range, including search-related words, content-related words, rankings, and relationship graph data. Inputs: - keyword (required): The keyword to analyze. - start_date (required): Start date as a YYYYMMDD string; Monday is recommended. - end_date (required): End date as a YYYYMMDD string; it must be a Sunday. A different weekday may result in empty data. - app_name (optional): aweme for Douyin (default), or toutiao for Toutiao. Results describe words associated with the keyword in search and content, along with rankings and graph relationships. The detailed result structure is not specified, so specific scores or graph fields are not guaranteed. Example: keyword="美食", start_date="20260330", end_date="20260405".
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
The fixed fee is 2.07 credits per call. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
keyword | string | Yes | 关键词/Keyword | — |
app_name | enum (aweme | toutiao) | No | 平台/Platform: aweme(抖音), toutiao(头条) | aweme |
end_date | string | Yes | 结束日期(必须为周日)/End date (must be Sunday) YYYYMMDD | — |
start_date | string | Yes | 开始日期(周一)/Start date (Monday) YYYYMMDD | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_index_fetch_relation_word' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"app_name": "aweme",
"end_date": "20261108",
"keyword": "浓香型白酒",
"start_date": "20261102"
}
}'{
"code": 200,
"data": {
"relation_word_list": [
{
"compos_index": "141842",
"content_list": [
{
"item_id": "7683879663714650214",
"title": "#中秋好礼 泸州老窖2斤蓝花瓷,限时149#蓝花瓷#泸州老窖",
"url": "https://www.douyin.com/video/7683879663714650214"
}
],
"correlation_change": false,
"relation_score": 0.07211552100768816,
"relation_word": "泸州老窖",
"score_rank": "3"
}
],
"word": "浓香型白酒"
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_relation_word_api_v1_douyin_index_fetch_relation_word_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "1a72cbaf-fa72-4ce3-903f-6dcb2ac9141c"
}This example shows part of the response. Copied content is valid JSON.

