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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 用于获取抖音话题(挑战/标签)搜索建议的请求体对象;其中 keyword 字段指定搜索关键词。 / Request body object for fetching Douyin topic (challenge/hashtag) search suggestions; the keyword field specifies the search keyword. | — |
request_body.keyword | string | No | 关键词,如 '游戏' / Keyword, e.g., 'game' | 游戏 |
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_search_fetch_challenge_suggest' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"keyword": "Vibe知识大赏"
}
}
}'{
"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.

