一、接口基本信息

接口名稱：抖音視頻搜索（關鍵詞）

接口版本：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）

必選參數

表格

可選篩選參數

表格

四、請求示例

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 限制（正式環境需申請提升）

內容受抖音內容安全策略過濾

僅返回 公開可見視頻

審核編輯 黃宇