一、關(guān)鍵詞搜索視頻（v2 版）

接口地址

plaintext

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

權(quán)限

Scope: aweme.dy.video_search_v2

需申請「抖音視頻垂搜」權(quán)限抖音開放平臺

請求頭

http

access-token: {你的client_token}
content-type: application/json

必選參數(shù)（Query）

keyword: 搜索關(guān)鍵詞（如 "美食教程"）

count: 每頁數(shù)量（建議 10-20）

device_id: 設(shè)備 ID（非字節(jié)租戶可傳隨機數(shù)）

cursor: 分頁游標(biāo)（首次傳 0）抖音開放平臺

可選篩選

sort_type: 0 = 綜合，1 = 最多點贊，2 = 最新發(fā)布

publish_time: 0 = 不限，1=1 天，7=7 天，180 = 半年

filter_duration: 時長篩選（0=1 分鐘內(nèi)，1~5，5~10000）抖音開放平臺

響應(yīng)（關(guān)鍵字段）

json

{
  "err_no": 0,
  "err_msg": "success",
  "data": {
    "cursor": 10,
    "has_more": true,
    "video_list": [
      {
        "item_id": "7471252140422401337", // 視頻ID（用于詳情）
        "title": "美食教程#家常菜",
        "cover": "封面圖URL",
        "create_time": 1739536450,
        "nickname": "作者昵稱",
        "statistics": { "digg_count": 9254 },
        "link": "https://www.douyin.com/video/7471252140422401337"
      }
    ]
  }
}
```{insert_element_3_}

---

### 二、視頻詳情（官方標(biāo)準(zhǔn)接口）
#### 1. 查詢特定視頻數(shù)據(jù)（用戶授權(quán)版）
**接口地址**

POST /api/apps/v1/video/query/

plaintext

**用途**：獲取**實時**播放、點贊、評論、分享等統(tǒng)計

**請求**
```http
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "open_id": "用戶open_id",
  "item_ids": ["7471252140422401337"] // 從搜索接口拿到的item_id
}

2. 視頻詳情頁跳轉(zhuǎn)鏈接（無授權(quán)版）

接口地址

plaintext

POST https://open.douyin.com/api/douyin/v1/schema/get_item_info/

用途：獲取可直接跳轉(zhuǎn) / 掃碼的 Schema 鏈接抖音開放平臺

請求

json

{
  "item_id": "7471252140422401337",
  "expire_at": 1744016400 // 過期時間戳
}
```{insert_element_5_}

**響應(yīng)**
```json
{
  "err_no": 0,
  "data": {
    "schema": "snssdk1128://openplatform/share?share_type=h5&item_id=7471252140422401337"
  }
}
```{insert_element_6_}

---

### 三、接入流程（最簡步驟）
1. **申請權(quán)限**
   - 抖音開放平臺 → 應(yīng)用 → 能力管理 → 申請「**抖音視頻垂搜**」{insert_element_7_}
2. **獲取 token**

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

plaintext

參數(shù)：`client_key`, `client_secret`{insert_element_8_}
3. **關(guān)鍵詞搜索** → 拿到 `item_id`
4. **查詳情/統(tǒng)計** → 用 `item_id` 調(diào)用詳情接口

---

### 四、常見錯誤
- `28001003`: `access-token` 無效/過期 → 重新獲取{insert_element_9_}
- `28001018`: 應(yīng)用**未開通**對應(yīng)接口權(quán)限 → 控制臺申請{insert_element_10_}
- `28003017`: 調(diào)用額度用盡 → 聯(lián)系平臺提升配額{insert_element_11_}

---

要不要我?guī)湍阏硪环菘芍苯舆\行的 **Python 調(diào)用示例**（包含關(guān)鍵詞搜索 + 詳情查詢）？

審核編輯 黃宇