一、接口基本信息

接口名稱(chēng)：抖音視頻搜索（關(guān)鍵詞）

接口版本：v2

HTTP 方法：GET

接口地址：

plaintext

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

權(quán)限 Scope：aweme.dy.video_search_v2

權(quán)限說(shuō)明：需在開(kāi)放平臺(tái)申請(qǐng) 「抖音視頻垂搜」 能力

授權(quán)方式：client_token（應(yīng)用級(jí)授權(quán)，無(wú)需用戶）

二、請(qǐng)求頭（Header）

http

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

獲取 client_token

http

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

請(qǐng)求參數(shù)：

client_key：平臺(tái)分配的 Key

client_secret：平臺(tái)分配的密鑰

grant_type：固定為 client_credential

三、請(qǐng)求參數(shù)（Query）

必選參數(shù)

表格

可選篩選參數(shù)

表格

四、請(qǐng)求示例

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

五、響應(yīng)結(jié)構(gòu)（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": "美食達(dá)人",
          "avatar": "https://p3-pc.byteimg.com/xxx.jpg"
        },
        "share_url": "https://www.douyin.com/video/7471252140422401337",
        "video_status": 1
      }
    ]
  }
}

關(guān)鍵字段說(shuō)明

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

cursor：下一頁(yè)游標(biāo)

has_more：是否還有更多數(shù)據(jù)

item_id：視頻唯一 ID（用于獲取詳情）

share_url：視頻播放頁(yè)鏈接

statistics：點(diǎn)贊 / 評(píng)論 / 分享 / 播放量

六、錯(cuò)誤碼（常見(jiàn)）

0：成功

28001003：access-token 無(wú)效 / 過(guò)期

28001018：未開(kāi)通 aweme.dy.video_search_v2 權(quán)限

28003017：調(diào)用頻次超限

28008001：關(guān)鍵詞為空或非法

七、使用限制

單請(qǐng)求 count 最大 20

接口有 QPS 限制（正式環(huán)境需申請(qǐng)?zhí)嵘?/p>

內(nèi)容受抖音內(nèi)容安全策略過(guò)濾

僅返回 公開(kāi)可見(jiàn)視頻

審核編輯 黃宇