说明

按 sec_user_id 翻页拉取抖音账号发布的视频。

基础信息

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

请求参数说明

参数	类型	必填	说明
sec_user_id	string	是	用户加密 ID
max_cursor	string	否	分页游标，首次 0
count	string	否	单页条数，默认 20
sort_type	string	否	排序：0=最新（默认），1=最热

响应字段说明

字段	类型	说明
code	int	业务状态码，200 表示成功
request_id	string	本次请求唯一标识，排查问题时可提供
data	object	业务数据容器，具体字段见下
aweme_list	array	视频列表，每条结构同「单视频详情」（aweme_id、desc、author、statistics、video 等）
max_cursor	int	下一页游标，回传即可翻页
has_more	int	是否还有更多：1 有 / 0 无

请求示例 · cURL

curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/douyin/app/v3/fetch_user_post_videos?sec_user_id=MS4wLjABA...&max_cursor=0&count=20&sort_type=0' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'

响应示例

{
  "code": 200,
  "request_id": "8aa027cb-b732-4f1a-b244-bf67bfc0705f",
  "data": {
    "request_item_cursor": 0,
    "max_cursor": 1775709426000,
    "extra": {
      "logid": "20260524171040E71B228344AFBEEDD712",
      "fatal_item_ids": [],
      "now": 1779613840000
    },
    "status_msg": "",
    "log_pb": {
      "impr_id": "20260524171040E71B228344AFBEEDD712"
    },
    "post_serial": 0,
    "replace_series_cover": 1,
    "min_cursor": 1779551213000,
    "has_more": 1,
    "status_code": 0,
    "aweme_list": [
      {
        "image_crop_ctrl": 0,
        "boost_status": 2,
        "is_multi_content": 1,
        "image_comment": {
          "comment_highlight_text": ""
        },
        "item_aigc_follow_shot": 1,
        "share_info": {
          "share_desc_info": "#在抖音，记录美好生活#战东京！为中国女子100米栏带回第一个世界田联洲际巡回赛金标赛事冠军。不负使命！",
          "bool_persist": 0,
          "share_quote": "",
          "share_signature_desc": "",
          "share_title_myself": "",
          "share_url": "https://www.iesdouyin.com/share/note/7370642490862374185/?region=US&mid=70183896...",
          "share_signature_url": "",
          "share_weibo_desc": "#在抖音，记录美好生活#战东京！为中国女子100米栏带回第一个世界田联洲际巡回赛金标赛事冠军。不负使命！",
          "share_desc": "在抖音，记录美好生活",
          "share_title": "战东京！为中国女子100米栏带回第一个世界田联洲际巡回赛金标赛事冠军。不负使命！",
          "share_title_other": "",
          "share_link_desc": "4.87 复制打开AI抖音，看看【吴艳妮Jennie的图文作品】战东京！为中国女子100米栏带回第一个世界田联洲际... %s [email protected] 12/31 :1p..."
        },
        "is_new_text_mode": 0,
        "mark_largely_following": false,
        "uniqid_position": null,
        "music": {
          "show_origin_clip": false,
          "collect_stat": 0,
          "redirect": false,
          "extra": "{\"aed_music_score\":0.02,\"aed_singing_score\":0.97,\"aggregate_exempt_conf\":[],\"aig...",
          "music_collect_count": 0,
          "cover_medium": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/146cbc7904bb422aaf2530728edd777a",
            "url_list": [
              "https://p3.douyinpic.com/aweme/200x200/tos-cn-v-2774c002/146cbc7904bb422aaf25307...",
              "... and 1 more"
            ],
            "width": 720
          },
          "id": 7018389662775445534,
          "cover_color_hsv": {
            "h": 2,
            "s": 35,
            "v": 62
          },
          "cover_hd": {
            "width": 720,
            "uri": "tos-cn
  ... // response truncated for docs (full size > 2KB)
}

开始调用 SpiderHubs API

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

获取 API Key 查看定价