抖音视频搜索
收藏接口说明
用户输入搜索词后，获取抖音视频相关内容的搜索结果信息。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/dy_open_api/v2/search/video/ |
| HTTP Method | GET |
| Scope | aweme.dy.video_search_v2 |
| 权限要求 | 抖音视频垂搜（对外） |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Query
count必填Int32
示例：10
每页数量
device_id必填Int64
设备 ID，非字节内部租户传入随机数即可
keyword必填String
关键词
cursorInt64
示例：0
分页游标, 第一页请求cursor是0, response中会返回下一页请求用到的cursor, 同时response还会返回has_more来表明是否有更多的数据。
open_idString
抖音 open_id
publish_timeInt32
示例：0
发布时间：0=不限；1=一天内；7=七天内；180=半年内
search_idString
示例：20231128162540BBD1B63E8FA76EE29F15
首刷不需要，但是往下滑触发loadmore需要带上第一刷返回的search_id
sort_typeInt32
示例：0
排序方式：0=综合排序；1=最多点赞；2=最新发布
请求示例
curl --location --request GET 'https://open.douyin.com/dy_open_api/v1/search/video/?keyword=xxx&count=10&cursor=0&device_id=12345' \ --header 'content-type: application/json' \ --header 'access-token: xxx'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
err_msg必填String
示例："access_token无效"
错误描述
err_no必填Int32
示例：28001003
错误码
log_id必填String
示例："202405291440576E078D8757B9"
日志id
响应示例
正常响应示例异常响应示例
{ "err_no": 0, "err_msg": "success", "log_id": "20240920182726FA858A69C020380590EF", "data": { "data": { "cursor": 2, "has_more": true, "video_list": [ { "item_id": "7471252140422401337", "title": "当我用人民币感受日本物价……#日本#日本旅游 #日本旅行 #旅行推荐官 #富士山", "cover": "https://p11-sign.douyinpic.com/tos-cn-i-0813c000-ce/oQA0ZPkAIi6AhMCOA8EPAvcnBAQP2d4BjEEJi~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1744016400&x-signature=BXLnWAQ3ap7JYdrELvaYvxQkg4Y%3D&from=327834062&s=PackSourceEnum_SEARCH&se=false&sc=cover&biz_tag=aweme_video&l=2025032417572142BB1BD9F1492C3BA340", "create_time": 1739536450, "avatar": "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-i-c9aec8xkvj_aa8323d1ebac49f1823f896d4b9b8e98.jpeg?from=3782654143", "nickname": "Nana在日本", "statistics": { "digg_count": 9254 }, "link": "https://www.douyin.com/video/7471252140422401337" } ], "search_id": "2025032417572142BB1BD9F1492C3BA340" } } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001005 | 系统内部错误，请重试 | 请求重试，若依然无解请向平台提交反馈 |
| 200 | 28001003 | access_token无效 | 重新请求生成access_token |
| 200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
| 200 | 28001016 | 当前应用已被封禁或下线 | clientKey被封禁或者下线 |
| 200 | 28001006 | 网络调用错误，请重试 | 重试即可 |
| 200 | 28001014 | 应用未授权任何能力 | 确认应用是否授权能力 |
| 200 | 28001018 | 应用未获得该能力 | 开通相关能力 |
| 200 | 28003017 | quota已用完 | 联系平台处理 |
| 200 | 28001019 | 应用该能力已被封禁 | 该能力被封禁，联系平台处理 |
| 200 | 28001007 | 参数不合法 | 根据错误信息检查请求参数是否填写正常 |
