Douyin Index Fetch Relation Word

2.07 credits/call
ae_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".

SocialResearch
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
keywordstringYes关键词/Keyword—
app_nameenum (aweme | toutiao)No平台/Platform: aweme(抖音), toutiao(头条)aweme
end_datestringYes结束日期(必须为周日)/End date (must be Sunday) YYYYMMDD—
start_datestringYes开始日期(周一)/Start date (Monday) YYYYMMDD—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.