说明

通过 unique_id（@username 后的部分）拉取用户主页信息，含 sec_uid、粉丝数、签名等。

基础信息

Endpoint:: GET /openapi/v1/contentcreator/tiktok/app/v3/handler_user_profile
计费:: 1 积分 / 次
限流:: 300 次 / 分钟 / 用户

请求参数说明

参数	类型	必填	说明
unique_id	string	是	用户名（不含 @），如 mrbeast

响应字段说明

字段	类型	说明
code	int	业务状态码，200 表示成功
request_id	string	本次请求唯一标识，排查问题时可提供
data	object	业务数据容器，具体字段见下
user	object	用户主页对象
uid / sec_uid	string	用户 ID / 加密 ID（翻页拉作品用 sec_uid）
nickname	string	昵称
unique_id	string	抖音号 / TikTok handle
signature	string	个性签名 / 简介
follower_count	int	粉丝数
following_count	int	关注数
aweme_count	int	作品数
total_favorited	int	获赞总数

请求示例 · cURL

curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/tiktok/app/v3/handler_user_profile?unique_id=mrbeast' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'

响应示例

{
  "code": 200,
  "request_id": "2a81ef5b-b8bc-4f67-96df-713174e87a33",
  "data": {
    "extra": {
      "fatal_item_ids": [],
      "logid": "202605240910312632B16BB7F3639B92BC",
      "now": 1779613831000
    },
    "log_pb": {
      "impr_id": "202605240910312632B16BB7F3639B92BC"
    },
    "status_code": 0,
    "status_msg": "",
    "user": {
      "account_type": 0,
      "ad_virtual": false,
      "avatar_168x168": {
        "uri": "tos-alisg-avt-0068/89b45c7902d0e75304be42748cd083d0",
        "url_list": [
          "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/89b45c7902d0e75304be...",
          "... and 2 more"
        ],
        "url_prefix": null
      },
      "avatar_300x300": {
        "uri": "tos-alisg-avt-0068/89b45c7902d0e75304be42748cd083d0",
        "url_list": [
          "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/89b45c7902d0e75304be...",
          "... and 3 more"
        ],
        "url_prefix": null
      },
      "avatar_larger": {
        "uri": "tos-alisg-avt-0068/89b45c7902d0e75304be42748cd083d0",
        "url_list": [
          "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/89b45c7902d0e75304be...",
          "... and 2 more"
        ],
        "url_prefix": null
      },
      "avatar_medium": {
        "uri": "tos-alisg-avt-0068/89b45c7902d0e75304be42748cd083d0",
        "url_list": [
          "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/89b45c7902d0e75304be...",
          "... and 4 more"
        ],
        "url_prefix": null
      },
      "avatar_thumb": {
        "uri": "tos-alisg-avt-0068/89b45c7902d0e75304be42748cd083d0",
        "url_list": [
          "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/89b45c7902d0e75304be...",
          "... and 3 more"
        ],
        "url_prefix": null
      },
      "aweme_count": 416,
      "bio_secure_url": "https://www.tiktoklinksafety.us/link/v2?aid=1233&lang=en&scene=bio_url&target=ht...",
      "bio_url": "https://www.instagram.com/stealthy.aep",
      "can_message_follow_status_list": [
        0,
        "... and 3 more"
      ],
      "category": "",
      "commerce_user_info": {
        "ad_revenue_rits": null
      },
      "commerce_user_level": 0,
      "custom_verify": "",
      "enterprise_verify_reason": "",
      "favoriting_count": 0,
      "follow_status": 0,
      "follower_count": 14905
  ... // response truncated for docs (full size > 2KB)
}

开始调用 SpiderHubs API

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

获取 API Key 查看定价