抖音关键词搜索视频的接口文档

一、接口基本信息

接口名称：抖音视频搜索（关键词）

接口版本：v2

HTTP 方法：GET

接口地址：

plaintext

 

https://open.douyin.com/dy_open_api/v2/search/video/

 

权限 Scope：aweme.dy.video_search_v2

权限说明：需在开放平台申请 「抖音视频垂搜」 能力

授权方式：client_token（应用级授权，无需用户）

二、请求头（Header）

http

 

access-token: {你的 client_token}
Content-Type: application/json

 

获取 client_token

http

 

POST https://open.douyin.com/oauth/client_token/

 

请求参数：

client_key：平台分配的 Key

client_secret：平台分配的密钥

grant_type：固定为 client_credential

三、请求参数（Query）

必选参数

表格

参数名	类型	说明
keyword	String	搜索关键词（如：美食教程）
count	Int32	每页数量（建议 10–20）
device_id	Int64	设备 ID（非字节租户可传随机数）
cursor	Int64	分页游标（首次请求传 0）

可选筛选参数

表格

参数名	类型	可选值	说明
sort_type	Int32	0 = 综合1 = 最多点赞2 = 最新发布	排序方式
publish_time	Int32	0 = 不限1=1 天内7=7 天内180 = 半年内	发布时间范围
filter_duration	Int32	0=1 分钟内1=1–5 分钟5=5 分钟以上	视频时长筛选
search_id	String	上一页返回值	分页加载时必须传入
open_id	String	用户 open_id	特定用户场景

四、请求示例

plaintext

 

GET https://open.douyin.com/dy_open_api/v2/search/video/
?keyword=美食教程
&count=10
&device_id=123456789
&cursor=0
&sort_type=1
&publish_time=7

 

五、响应结构（JSON）

json

 

{
  "err_no": 0,
  "err_msg": "success",
  "data": {
    "cursor": 10,
    "has_more": true,
    "search_id": "20260414133000ABC123DEF456",
    "video_list": [
      {
        "item_id": "7471252140422401337",
        "title": "家常菜教程 #美食",
        "cover": "https://p3-pc.byteimg.com/xxx.jpg",
        "create_time": 1739536450,
        "duration": 85,
        "statistics": {
          "digg_count": 12500,
          "comment_count": 860,
          "share_count": 2100,
          "play_count": 568000
        },
        "author": {
          "uid": "100000000000000",
          "nickname": "美食达人",
          "avatar": "https://p3-pc.byteimg.com/xxx.jpg"
        },
        "share_url": "https://www.douyin.com/video/7471252140422401337",
        "video_status": 1
      }
    ]
  }
}

 

关键字段说明

err_no：0 = 成功，非 0 = 失败

cursor：下一页游标

has_more：是否还有更多数据

item_id：视频唯一 ID（用于获取详情）

share_url：视频播放页链接

statistics：点赞 / 评论 / 分享 / 播放量

六、错误码（常见）

0：成功

28001003：access-token 无效 / 过期

28001018：未开通 aweme.dy.video_search_v2 权限

28003017：调用频次超限

28008001：关键词为空或非法

七、使用限制

单请求 count 最大 20

接口有 QPS 限制（正式环境需申请提升）

内容受抖音内容安全策略过滤

仅返回 公开可见视频

审核编辑 黄宇