Douyin Search Fetch Challenge Suggest

20.65 credits/call
ae_douyin_search_fetch_challenge_suggest

## Purpose Find Douyin topic, hashtag, and challenge suggestions related to a keyword. Useful for search autocomplete and discovering relevant topics. ## Input - `request_body` (required object): request payload. - `request_body.keyword` (optional string): search keyword, such as `游戏`; the schema default is `游戏`. Example: ```json {"request_body":{"keyword":"游戏"}} ``` Only the keyword is exposed inside the request body; pagination inputs are not supported by this tool's public schema. ## Result The response envelope includes `code` (HTTP status code), `data` (result data), and response metadata. Documented common fields in the result data include: - `sug_list`: suggested topics, with `cha_name` (topic name), `view_count` (total views), `cid` (challenge ID), `group_id` (associated group ID), and `tag` (0 = normal topic, 1 = hot trend). - `status_code`: result status; 0 indicates success. - `status_msg`: result status message. - `rid`: result request ID; additional query and logging metadata may also be present. The result data has an open-ended schema; actual fields and their availability depend on the response. These are topic suggestions, not video or user search results.

SocialSearch
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.65 credits/call

Each call has a fixed charge of 20.65 credits. 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
request_bodyobjectYes用于获取抖音话题(挑战/标签)搜索建议的请求体对象;其中 keyword 字段指定搜索关键词。 / Request body object for fetching Douyin topic (challenge/hashtag) search suggestions; the keyword field specifies the search keyword.—
request_body.keywordstringNo关键词,如 '游戏' / Keyword, e.g., 'game'游戏

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_search_fetch_challenge_suggest' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "keyword": "Vibe知识大赏"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "extra": {
      "fatal_item_ids": [],
      "logid": "2026111019360846276967B6FE44CAE0CD",
      "now": 1794310568000,
      "scenes": null,
      "search_request_id": ""
    },
    "log_pb": {
      "impr_id": "2026111019360846276967B6FE44CAE0CD"
    },
    "rid": "2026111019360846276967B6FE44CAE0CD",
    "status_code": 0,
    "status_msg": "",
    "sug_list": [
      {
        "cha_name": "Vibe知识大赏",
        "cid": "7690834868800620595",
        "group_id": "7689470371942405422",
        "tag": 0,
        "view_count": 4187164599
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_challenge_suggest_api_v1_douyin_search_fetch_challenge_suggest_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "keyword": "Vibe知识大赏"
  }
}

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