WellbyteWellbyte

POST /v1/douyin/search/fetch_user_search

获取用户搜索

stable · 13 credits / 次（成功才计）

获取抖音 App 中根据关键词搜索到的用户列表。；支持通过粉丝数量、用户类型进行筛选查询。；备注；初次请求 `cursor` 传 0，`search_id` 传空字符串。；返回的数据仅包含「用户信息」，不包括视频、话题、音乐等内容。；keyword: 搜索关键词，如 "人工智能"；cursor: 翻页游标（首次请求传0）；douyin_user_fans: 粉丝数量筛选；- 为空: 不限；- "0_1k": 1000以下；- "1k_1w": 1000到1万；- "1w_10w": 1万到10万；- "10w_100w": 10万到100万；- "100w_": 100万以上；douyin_user_type: 用户类型筛选；- "common_user": 普通用户；- "enterprise_user": 企业认证用户；- "personal_user": 个人认证用户；search…

注册即送 500 credits，用自己的 Key 试调。 免费注册

请求

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_user_search' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"cursor":null,"keyword":"咖啡","search_id":"demo","douyin_user_fans":"demo","douyin_user_type":"demo"}'
免费注册

响应

示例采集于 2026-08-25

data{
code:0
data{
qc:""
rid:"20260826005531BA1F1A5A34C57EF8B8DA"
type:1
extra{ 6 items }
cursor:10
log_pb{ 2 items }
has_more:1
user_list[ 2 items ]
music_list:null
status_code:0
input_keyword:"猫咪"
challenge_list:null
myself_user_id:"0"
global_doodle_config{ 3 items }
}
meta{
endpoint:"douyin.search.fetch_user_search"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

请求历史

打开完整日志

还没有调用记录。先跑通一次，再换成你的数据。

    请求参数

    参数类型位置必填说明示例
    cursorintegerbody否偏移游标，用于翻页，从上一次请求返回的响应中获取demo
    keywordstringbody否关键词咖啡
    search_idstringbody否搜索ID，用于翻页，从上一次请求返回的响应中获取demo
    douyin_user_fansstringbody否粉丝数过滤：空=不限 0_1k=1千以下 1k_5k=1千到5千 5k_10k=5千到1万 10k_100k=1万到10万 100k_1M=10万到100万 1M_=100万以上demo
    douyin_user_typestringbody否用户类型过滤：空=不限 300=创作者 900=小店 700=音乐人 800=明星demo

    响应字段

    字段字典待补 —— 右侧可执行区可直接看到真实结构。

    错误码

    codeHTTP含义是否计费
    40001400参数缺失或格式错误否
    40102401API Key 无效或已吊销否
    40201402余额不足，请充值否
    40402404目标资源不存在否
    42201422质量门槛未通过否
    42901429超出速率限制否
    50401504上游超时否
    50201502上游返回异常否

    计费

    成功扣 13 credits；任何失败（含上游 200 但未过质量门槛）扣 0。

    搜索

    搜索端点与文档