Douyin Fetch Creator User Search

2.07 credits/call
ae_douyin_fetch_creator_user_search

Search Douyin users by Douyin ID or nickname. Input: user_name (required string), for example "rmrbxmt", "Y", or "人民日报". Returns: Up to 20 matching users, including basic profile information such as avatar, nickname, and Douyin ID. Results are search matches and do not necessarily identify a unique account; the available profile fields depend on the returned data.

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
user_namestringYes用户名/Username (支持抖音号和抖音昵称)—

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_fetch_creator_user_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "user_name": "zrihk"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "status_code": 0,
    "status_msg": "",
    "user_infos": [
      {
        "avatar": "https://p11.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-c9aec8xkvj_4819ee0a6ffc4a98a637d0df7fa34965.jpeg?from=3782654143",
        "nick_name": "择日花开",
        "short_id": "zrihk",
        "user_id": "109259234404"
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Creator-API/fetch_user_search_api_v1_douyin_creator_fetch_user_search_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "user_name": "zrihk"
  }
}

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