Douyin Search Fetch User Search
按关键词搜索抖音账号,每次返回一页搜索结果。默认使用完整查询,支持粉丝数和用户类型筛选、沿用已有搜索会话 ID(search_id),结果可能包含数字用户 ID(UID)。只有 require_numeric_uid=false,且 douyin_user_fans、douyin_user_type 和 search_id 均为空时,才使用基础搜索;基础搜索不保证返回数字 UID。翻页时保持关键词、筛选条件和 require_numeric_uid 选项不变,使用对应响应返回的游标;完整查询还需沿用对应响应中的搜索会话 ID。完整查询与基础搜索的响应结构可能不同,请按实际响应读取结果和翻页信息。
Pricing
| Condition | Charge |
|---|---|
| require numeric user UID is explicitly set to false and follower filter is blank or omitted and account type filter is blank or omitted and search session ID is blank or omitted | 2.07 credits/call |
| Otherwise | 20.65 credits/call |
Each call selects one fixed price based on the request. require numeric user UID is explicitly set to false and follower filter is blank or omitted and account type filter is blank or omitted and search session ID is blank or omitted: 2.07 credits/call. Otherwise: 20.65 credits/call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 抖音用户搜索请求体对象,包含搜索关键词 keyword、翻页游标 cursor、翻页搜索 ID search_id,以及粉丝数量筛选 douyin_user_fans 和用户类型筛选 douyin_user_type。首次请求使用 cursor=0、search_id="";翻页时使用上一次响应返回的游标和搜索 ID。 / Request body object for Douyin user search, containing the search keyword (keyword), pagination cursor (cursor), search session ID (search_id), follower-count filter (douyin_user_fans), and user-type filter (douyin_user_type). For the first request, use cursor=0 and search_id=""; for subsequent pages, use the cursor and search ID from the preceding response. | — |
request_body.cursor | integer | No | 偏移游标,用于翻页,从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response | 0 |
request_body.keyword | string | No | 关键词 / Keyword | 猫咪 |
request_body.search_id | string | No | 搜索ID,用于翻页,从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response | "" |
request_body.douyin_user_fans | string | No | 粉丝数过滤:空=不限 0_1k=1千以下 1k_5k=1千到5千 5k_10k=5千到1万 10k_100k=1万到10万 100k_1M=10万到100万 1M_=100万以上 / Fans filter: empty=No limit, 0_1k=Under 1k, etc. | "" |
request_body.douyin_user_type | string | No | 用户类型过滤:空=不限 300=创作者 900=小店 700=音乐人 800=明星 / User type filter: empty=No limit, 300=Creator, 900=Shop, 700=Musician, 800=Celebrity | "" |
require_numeric_uid | boolean | No | 是否需要数字用户ID。默认true,使用支持筛选的完整查询;明确设为false且未使用粉丝数、用户类型筛选或search_id时,可使用基础查询。基础查询不保证返回数字用户ID。 | true |
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_user_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"cursor": 10,
"douyin_user_fans": "100k_1M",
"douyin_user_type": "300",
"keyword": "脑科学",
"search_id": ""
}
}
}'{
"detail": {
"code": 400,
"docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_user_search_api_v1_douyin_search_fetch_user_search_post",
"headers": {},
"message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
"message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
"params": {
"cursor": 10,
"douyin_user_fans": "100k_1M",
"douyin_user_type": "300",
"keyword": "脑科学",
"search_id": ""
}
}
}This example shows part of the response. Copied content is valid JSON.

