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

一、接口基本信息

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

• 接口版本：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 限制（正式环境需申请提升）抖音开放平台
• 内容受抖音内容安全策略过滤抖音开放平台
• 仅返回 公开可见视频抖音开放平台