Douyin Search Fetch Search Suggest

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

Social
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 search suggestions; keyword is the input term used to generate related search keyword suggestions.—
request_body.keywordstringNo需要联想的关键词/The keyword to be suggested人工智能

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_search_suggest' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "keyword": "职业倦怠"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.