返回调试台

获取用户喜欢的作品列表 API

POST /api/plugins/douyin/user_favorites

接口描述

输入 sec_uid 或包含 sec_uid 的分享文案,获取喜欢列表,支持游标翻页。

请求参数

参数名 类型 必选 描述
apiKey string 用户 API Key
shareText string 抖音用户主页的分析链接,无需base64,content-type为application/json
cursor string 分页指示器,分页的时候请使用上一次请求返回的cursor

计费说明

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

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

响应参数

参数名 类型 描述
code number 状态码 (0 表示成功)
success boolean 请求是否成功
msg string 状态描述信息
data object 数据对象
data.has_more number 是否有更多数据 (1: 有, 0: 无)
data.cursor number 下一页游标
data.items array 视频列表
data.items[].shareUrl string 视频分享链接
data.items[].desc string 视频描述
data.items[].duration number 视频时长 (毫秒)
data.items[].digg_count number 点赞数
data.items[].share_count number 分享数
data.items[].collect_count number 收藏数
data.items[].comment_count number 评论数
usage object 用量信息
usage.cost number 本次消耗用量

示例

请求示例

curl -X POST "https://cyanlis.cn/api/plugins/douyin/user_favorites?apiKey=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "shareText": "..." }'

响应示例

Loading...

错误码

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