返回调试台
接口描述
根据关键字搜索抖音视频（需登录 Cookie），支持翻页（offset/cursor）与会话ID（searchId）。
请求参数
| 参数名 |
类型 |
必选 |
描述 |
| keyword |
string |
是 |
搜索关键字 |
| cookie |
string |
是 |
抖音官网登录后的 Cookie |
| apiKey |
string |
是 |
用户 API Key |
| offset |
number |
否 |
偏移量 第一次请传入 0 后续翻页请传入返回参数中的cursor |
| searchId |
string |
否 |
会话ID (首次留空) 后续翻页请传入返回参数中的searchId |
计费说明
本接口每次调用扣除 5 次用量。
👉 用量管理：您可以前往 API 插件中心 查看剩余用量及进行充值。
响应参数
| 参数名 |
类型 |
描述 |
| code |
number |
状态码 (0 表示成功) |
| success |
boolean |
请求是否成功 |
| msg |
string |
状态描述信息 |
| data |
object |
数据对象 |
| data.hasMore |
string |
是否有更多数据 ("0"或"1") |
| data.cursor |
string |
下一页游标 (offset) |
| data.searchId |
string |
搜索会话 ID |
| data.items |
array |
视频列表 |
| data.items[].title |
string |
视频标题/描述 |
| data.items[].shareUrl |
string |
视频分享链接 |
| data.items[].nickname |
string |
作者昵称 |
| data.items[].userShareUrl |
string |
作者主页分享链接 |
| data.items[].duration |
number |
视频时长(ms) |
| data.items[].digg_count |
number |
点赞数 |
| data.items[].comment_count |
number |
评论数 |
| data.items[].collect_count |
number |
收藏数 |
| data.items[].share_count |
number |
分享数 |
| data.items[].post_time |
string |
发布时间 (YYYY-MM-DD HH:mm:ss) |
| usage |
object |
用量信息 |
| usage.cost |
number |
本次消耗用量 |
示例
请求示例
curl -X GET "https://cyanlis.cn/api/plugins/douyin/video_search?keyword=...&cookie=...&apiKey=YOUR_API_KEY"
响应示例
Loading...
错误码
| 错误码 |
描述 |
解决方案 |
| 401 |
Unauthorized |
API Key 无效或过期，请检查 Key 是否正确 |
| 400 |
Bad Request |
请求参数错误 |
| 403 |
Forbidden |
余额不足或权限受限 |
| 500 |
Internal Server Error |
服务器内部错误，请联系技术支持 |