Douyin Search Fetch Search Suggest
## Purpose Get suggested Douyin search phrases related to an input keyword, for search-box autocomplete or query refinement. This tool returns keyword suggestions rather than videos or search-volume statistics. ## Input - `request_body` (required object): Contains the search-suggestion input. - `request_body.keyword` (optional string): The term to expand. The schema default is `人工智能`. Set it explicitly to request suggestions for your intended term. Example: ```json {"request_body":{"keyword":"人工智能"}} ``` ## Result The response envelope includes `code` (HTTP status code), `message` and `data` (the result payload, which may be null). The documented payload includes: - `status_code`: Result status; `0` indicates success. - `status_msg`: Result message. - `sug_list`: Suggested search phrases. Each item's `content` is the suggested text; `pos` describes matching character positions, and `word_record` contains suggestion metadata such as its position and text. Additional request identifiers and metadata may be present. The detailed payload is not fixed by the response schema; inspect the actual response for available fields and distinguish the envelope's `code` from the payload's `status_code`. Suggestions are not evidence of search volume or popularity.
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 search suggestions; keyword is the input term used to generate related search keyword suggestions. | — |
request_body.keyword | string | No | 需要联想的关键词/The keyword to be suggested | 人工智能 |
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_search_suggest' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"keyword": "职业倦怠"
}
}
}'{
"code": 200,
"data": {
"cache_conf": {
"enable": false
},
"extra": {
"fatal_item_ids": [],
"logid": "202611111740380C8DAC6A63A1E4331BA6",
"now": 1794390038000,
"search_request_id": ""
},
"log_pb": {
"impr_id": "202611111740380C8DAC6A63A1E4331BA6"
},
"rid": "202611111740380C8DAC6A63A1E4331BA6",
"status_code": 0,
"status_msg": ""
},
"docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_search_suggest_api_v1_douyin_search_fetch_search_suggest_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"keyword": "职业倦怠"
}
}This example shows part of the response. Copied content is valid JSON.

