说明

关键词搜索抖音用户。

基础信息

Endpoint:: POST /openapi/v1/contentcreator/douyin/search/fetch_user_search
计费:: 1 积分 / 次
限流:: 300 次 / 分钟 / 用户

请求参数说明

参数	类型	必填	说明
keyword	string	是	搜索关键词
douyin_user_type	string	否	用户类型筛选；不填则不限
search_id	string	否	搜索会话 ID，翻页用

响应字段说明

字段	类型	说明
code	int	业务状态码，200 表示成功
request_id	string	本次请求唯一标识，排查问题时可提供
data	object	业务数据容器，具体字段见下
user_list	array	用户列表，每条含 uid、sec_uid、nickname 昵称、unique_id 账号、avatar 头像、follower_count 粉丝数
cursor / search_id	string	翻页游标 / 搜索会话 ID
has_more	int	是否还有更多

请求示例 · cURL

curl -X POST 'https://api.spiderhubs.com/openapi/v1/contentcreator/douyin/search/fetch_user_search?keyword=ai' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{}'

响应示例

{
  "code": 200,
  "request_id": "f0d7c199-2f31-49c0-b712-d6ec49ee0e21",
  "data": {
    "type": 1,
    "user_list": [
      {
        "position": null,
        "uniqid_position": null,
        "effects": null,
        "musics": null,
        "items": null,
        "mix_list": null,
        "challenges": null,
        "dynamic_patch": {
          "height": 80,
          "schema": "aweme://lynxview/?channel=morphling_high&bundle=channel_user%2Findex%2Ftemplate....",
          "origin_type": 4,
          "raw_data": "{\"phone_number_encrypted\":null,\"user_info\":{\"uid\":\"3742365079585163\",\"nickname\":..."
        },
        "product_info": null,
        "product_list": null,
        "baikes": null,
        "userSubLightApp": null,
        "shop_product_info": null,
        "user_service_info": null,
        "fandoms": null
      },
      "... and 9 more"
    ],
    "challenge_list": null,
    "music_list": null,
    "cursor": 10,
    "has_more": 1,
    "status_code": 0,
    "qc": "",
    "myself_user_id": "0",
    "rid": "20260524171046FC3E821F4C560EFB3370",
    "log_pb": {
      "impr_id": "20260524171046FC3E821F4C560EFB3370",
      "stab_extra": {
        "traffic_identification": "normal"
      }
    },
    "extra": {
      "now": 1779613847059,
      "logid": "20260524171046FC3E821F4C560EFB3370",
      "fatal_item_ids": [],
      "search_request_id": "",
      "start_ms": 1779613846702,
      "scenes": null
    },
    "input_keyword": "猫咪",
    "global_doodle_config": {
      "keyword": "猫咪",
      "filter_show_dot": 1640995200,
      "filter_settings": [
        {
          "name": "douyin_user_fans",
          "default_index": 0,
          "log_name": "by_user_fans",
          "items": [
            {
              "value": "",
              "log_value": "fans_all",
              "title": "不限"
            },
            "... and 5 more"
          ],
          "title": "粉丝数量"
        },
        "... and 1 more"
      ]
    }
  }
}

开始调用 SpiderHubs API

使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。

获取 API Key 查看定价