抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

获取作者视频列表

收藏
我的收藏

接口说明

  • 调用方是小程序的开发者/代开发
  • 视频作者ID有授权给小程序“查询作者视频列表”能力

使用限制

基本信息

名称描述
HTTP URL
https://open.douyin.com/aweme/v1/video/self/get_user_video_list/
HTTP Method
POST
Scope
ma.self_mount_video.item_list
权限要求

请求参数

请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例:application/json
固定值"application/json"
Body
aweme_id必填String
示例:9810851****

作者的抖音号

count必填Int16
示例:10
每次查询视频个数(0<count<=100)
cursor必填Int64
示例:1694922821067

距当前时间30天内的毫秒级时间戳(若查询第一页可传入0或当前毫秒级时间戳,后续可传入返回值中的max_cursor来查询下一页)

请求示例
curl --location --request POST 'https://open.douyin.com/aweme/v1/video/self/get_user_video_list/' \ --header 'Access-Token: clt.30bb42d8925a6aa1e67e507705aa9cc1WSNsalwI0yNt4eqjkIC9CSDoSm0F' \ --header 'Content-Type: application/json' \ --data-raw '{"aweme_id":"981085136**","cursor":1695355346000,"count":2}'

响应参数

Body展开全部子属性
data必填Struct
展开子属性
err_msg必填String
示例:"access_token无效"
错误描述
err_no必填Int32
示例:28001003
错误码
log_id必填String
示例:"202405291440576E078D8757B9"
日志id
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "", "log_id": "20231017211158A06A8057AFF4C859C***", "data": { "has_more": true, "max_cursor": 1695355072000, "user_publish_item_list": [ { "create_time": "2023-09-22 11:59:30", "item_id": 729043528000000000, "video_link": "https://www.douyin.com/video/7281494943544249***" }, { "create_time": "2023-09-22 11:57:52", "item_id": 729043528000000000, "video_link": "https://www.douyin.com/video/7281494507227467***" } ] } }
切换单列布局

错误码

HTTP 状态码错误码错误码描述排查建议
20028001005
系统内部错误,请重试
请求重试,若依然无解请向平台提交反馈
20028001003
access_token无效
重新请求生成access_token
20028001008
access_token过期,请刷新或重新授权
重新请求生成access_token
20028001016
当前应用已被封禁或下线
clientKey被封禁或者下线
20028001006
网络调用错误,请重试
重试即可
20028001014
应用未授权任何能力
确认应用是否授权能力
20028001018
应用未获得该能力
开通相关能力
20028003017
quota已用完
联系平台处理
20028001019
应用该能力已被封禁
该能力被封禁,联系平台处理
20028001007
参数不合法
根据错误信息检查请求参数是否填写正常
20029003022
小程序无短视频自主挂载能力
小程序没有自挂载权限
20029003023
用户与小程序无自挂载关系
需要用户授权自挂载关系
20029003024
请求参数不合法
入参均必传,且需要符合参数规范
20029003027
当前用户id不存在
20029003028
该用户近三十天内未发布公开视频
20029003029
无权限查询该作者的视频
需要用户授权能力
20029003040
当前时间戳不合法,请传入0或30天内的毫秒级时间戳
若要查询第一页则传入0,否则传入距离当前时间30天内的毫秒级时间戳