TikTok — 用户作品列表
SpiderHubs OpenAPI 文档:TikTok — 用户作品列表,分类 TikTok。接口 GET /openapi/v1/contentcreator/tiktok/app/v3/fetch_user_post_videos。按 sec_user_id 翻页拉取一个 TikTok 账号发布的视频。
OpId:
tt-user-post-videos · 最近更新: 2026-05-23说明
按 sec_user_id 翻页拉取一个 TikTok 账号发布的视频。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/tiktok/app/v3/fetch_user_post_videos
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sec_user_id | string | 是 | 用户加密 ID(从主页 URL 或 share link 提取) |
| max_cursor | string | 否 | 分页游标,首次 0;下次用响应里的 max_cursor |
| count | string | 否 | 单页条数,默认 20,上限 35 |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| 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/tiktok/app/v3/fetch_user_post_videos?sec_user_id=MS4wLjABA...&max_cursor=0&count=10' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "65bf76f6-3e76-4026-b959-610f4b0a985f",
"data": {
"status_code": 0,
"min_cursor": 1779552939305,
"max_cursor": 1779271899255,
"has_more": 1,
"aweme_list": [
{
"aweme_id": "7643121648597536020",
"desc": "Sukuna> | SONG: MONTAGEM LAGANDO | #sukunaryomen #sukunaedit #ryomensukunaedit ...",
"create_time": 1779552939,
"author": {
"uid": "6896747184255927302",
"short_id": "0",
"nickname": "Stealthy.vfx",
"signature": "Adobe AE 2020\nJUJUTSU KAISEN EDITOR \n🫸🏻🔴🔵🫷🏻🤌🏻=🟣\nADS write ✍️- IG 👇",
"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"
],
"width": 720,
"height": 720,
"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 2 more"
],
"width": 720,
"height": 720,
"url_prefix": null
},
"avatar_medium": {
"uri": "tos-alisg-avt-0068/89b45c7902d0e75304be42748cd083d0",
"url_list": [
"https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/89b45c7902d0e75304be...",
"... and 2 more"
],
"width": 720,
"height": 720,
"url_prefix": null
},
"follow_status": 0,
"aweme_count": 416,
"following_count": 31,
"follower_count": 149057,
"favoriting_count": 49353,
"total_favorited": 17382652,
"is_block": false,
"hide_search": false,
"custom_verify": "",
"unique_id": "stealthy.vfx",
"bind_phone": "",
"special_lock": 1,
"need_recommend": 0,
"has_facebook_token": false,
"has_twitter_token": false,
"fb_expire_time": 0,
"tw_expire_time": 0,
"has_youtube_token": false,
"youtube_expire_time": 0,
"room_id": 0,
... // response truncated for docs (full size > 2KB)
}开始调用 SpiderHubs API
使用账户中心生成的 API Key,通过 Authorization: Bearer sk_live_xxx 调用接口。