返回调试台

获取抖音用户发布的作品列表 API

GET /api/plugins/douyin/user_posts

接口描述

根据用户ID（或 sec_uid）查询其作品列表（需登录 Cookie），支持排序与翻页。

请求参数

参数名 类型 必选 描述
userId string 是 用户ID (sec_uid 或用户主页链接)
cookie string 是 抖音官网登录后的 Cookie
apiKey string 是 用户 API Key
sortType number 否 排序方式 (0:默认, 1:按热度)
cursor string 否 分页信息，第一次请求传入空字符串，后续传入前一次请求data下的max_cursor

计费说明

本接口每次调用扣除 1 次用量。

👉 用量管理：您可以前往 API 插件中心 查看剩余用量及进行充值。

响应参数

参数名 类型 描述
code number 状态码，0 表示成功
success boolean 请求是否成功
msg string 提示信息（包含本次消耗及剩余用量）
data object 作品列表核心数据
  └─ cursor number 下一页游标
  └─ max_cursor number 最大游标 (通常同 cursor)
  └─ min_cursor number 最小游标
  └─ has_more number 是否还有更多数据 (1:是, 0:否)
  └─ aweme_list array 作品列表
    └─ aweme_id string 视频唯一标识 ID
    └─ desc string 视频文案
    └─ create_time number 发布时间戳
    └─ media_type number 媒体类型 (2:图集, 4:视频)
    └─ is_top number 是否置顶 (1:是)
    └─ statistics object 统计数据
      └─ digg_count number 点赞数
      └─ comment_count number 评论数
      └─ share_count number 分享数
      └─ collect_count number 收藏数
      └─ play_count number 播放数
      └─ download_count number 下载数
      └─ forward_count number 转发数
    └─ video object 视频媒体信息
      └─ play_addr object 播放地址信息
        └─ url_list array 视频播放地址列表 (无水印)
      └─ cover object 封面图信息
      └─ duration number 视频时长（毫秒）
      └─ width number 视频宽度
      └─ height number 视频高度
      └─ ratio string 视频分辨率 (e.g., "1080p")
    └─ author object 作者简要信息
      └─ uid string 作者 UID
      └─ sec_uid string 作者 Sec UID
      └─ nickname string 作者昵称
      └─ signature string 作者签名
      └─ avatar_thumb object 头像缩略图
    └─ music object 背景音乐信息
      └─ id number 音乐 ID
      └─ title string 音乐标题
      └─ author string 音乐作者
      └─ play_url object 音乐播放地址
      └─ cover_thumb object 音乐封面
    └─ share_info object 分享信息
      └─ share_url string 分享链接
      └─ share_desc string 分享描述
    └─ status object 视频状态信息
      └─ is_delete boolean 是否已删除
      └─ allow_share boolean 是否允许分享
    └─ risk_infos object 风险控制信息
    └─ video_labels array 视频标签
    └─ poi_info object 地理位置信息 (POI)
      └─ poi_name string 位置名称
      └─ address_info object 详细地址信息
    └─ text_extra array 文本扩展信息 (话题、艾特等)
    └─ images array 图集 (如果是图文内容)
    └─ image_infos array 图片详细信息列表

示例

请求示例

curl -X GET "https://cyanlis.cn/api/plugins/douyin/user_posts?userId=...&cookie=...&apiKey=YOUR_API_KEY"

响应示例

Loading...

错误码

错误码 描述 解决方案
401 Unauthorized API Key 无效或过期，请检查 Key 是否正确
400 Bad Request 请求参数错误
403 Forbidden 余额不足或权限受限
500 Internal Server Error 服务器内部错误，请联系技术支持