Douyin Billboard Fetch Hot Account Search List

2.07 credits/call
ae_douyin_billboard_fetch_hot_account_search_list

Search for Douyin accounts by username or Douyin ID. Inputs: - keyword (required string): The username or Douyin ID to search for. - cursor (required integer): The pagination cursor. The documented example is 0; the input schema does not provide an automatic default, so supply this parameter explicitly. Returns: A response containing search results in data, which may be null, together with response status information. The available account fields and pagination metadata are not specified; use the actual response rather than assuming a fixed result structure.

Social
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
cursorintegerYes游标,默认空—
keywordstringYes搜索的用户名或抖音号—

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_billboard_fetch_hot_account_search_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "cursor": 0,
    "keyword": "cq17210"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "user_list": [
        {
          "avatar_url": "https://p11.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_abef3be2af1208fb567f3d2fe55927e1.jpeg?from=2956013662",
          "fans_cnt": 1828,
          "like_cnt": 24437,
          "monitor_id": 0,
          "monitor_status": 0,
          "new_fans_cnt": 0
        }
      ]
    }
  },
  "docs": "https://api.tikhub.io/#/Douyin-Billboard-API/fetch_hot_account_search_list_api_v1_douyin_billboard_fetch_hot_account_search_list_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "4b46e659-3df0-4229-83b8-af73d820e430"
}

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