Douyin Index Fetch Topic Query

2.07 credits/call
ae_douyin_index_fetch_topic_query

Search for topics by keyword on Douyin or Toutiao within a specified date range. Inputs: - keyword (required): The topic keyword to search for. - start_date (required): Start date as a YYYYMMDD string. - end_date (required): End date as a YYYYMMDD string. - app_name (optional): aweme for Douyin (default), or toutiao for Toutiao. Returns: Response status information and a data payload containing topic details and related metrics, such as topic popularity and related video counts, when available. The payload may be null, and its exact fields are not fixed by the documented response schema; use the fields actually returned. Example: keyword="旅行", start_date="20260406", end_date="20260412", app_name="aweme".

SocialResearch
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/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话题关键词/Topic keyword—
app_nameenum (aweme | toutiao)No平台/Platform: aweme(抖音), toutiao(头条)aweme
end_datestringYes结束日期/End date YYYYMMDD—
start_datestringYes开始日期/Start date 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_topic_query' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "app_name": "aweme",
    "end_date": "20261111",
    "keyword": "供热管道",
    "start_date": "20261104"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "BaseResp": {
      "StatusCode": 0,
      "StatusMessage": ""
    },
    "topic_list": [
      {
        "datetime": "",
        "digg_cnt": "765",
        "item_cnt": "22",
        "play_read_cnt": "139559",
        "topic_id": "1663060989747213",
        "topic_index": "807"
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_topic_query_api_v1_douyin_index_fetch_topic_query_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "app_name": "aweme",
    "end_date": "20261111",
    "keyword": "供热管道",
    "start_date": "20261104"
  }
}

This example shows part of the response. Copied content is valid JSON.