抖音关键词搜索，视频详情api

一、关键词搜索视频（v2 版）

接口地址

plaintext

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

权限

Scope: aweme.dy.video_search_v2

需申请「抖音视频垂搜」权限抖音开放平台

请求头

http

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

必选参数（Query）

keyword: 搜索关键词（如 "美食教程"）

count: 每页数量（建议 10-20）

device_id: 设备 ID（非字节租户可传随机数）

cursor: 分页游标（首次传 0）抖音开放平台

可选筛选

sort_type: 0 = 综合，1 = 最多点赞，2 = 最新发布

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

filter_duration: 时长筛选（0=1 分钟内，1~5，5~10000）抖音开放平台

响应（关键字段）

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_}

---

### 二、视频详情（官方标准接口）
#### 1. 查询特定视频数据（用户授权版）
**接口地址**

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

plaintext

**用途**：获取**实时**播放、点赞、评论、分享等统计

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

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

2. 视频详情页跳转链接（无授权版）

接口地址

plaintext

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

用途：获取可直接跳转 / 扫码的 Schema 链接抖音开放平台

请求

json

{
  "item_id": "7471252140422401337",
  "expire_at": 1744016400 // 过期时间戳
}
```{insert_element_5_}

**响应**
```json
{
  "err_no": 0,
  "data": {
    "schema": "snssdk1128://openplatform/share?share_type=h5&item_id=7471252140422401337"
  }
}
```{insert_element_6_}

---

### 三、接入流程（最简步骤）
1. **申请权限**
   - 抖音开放平台 → 应用 → 能力管理 → 申请「**抖音视频垂搜**」{insert_element_7_}
2. **获取 token**

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

plaintext

参数：`client_key`, `client_secret`{insert_element_8_}
3. **关键词搜索** → 拿到 `item_id`
4. **查详情/统计** → 用 `item_id` 调用详情接口

---

### 四、常见错误
- `28001003`: `access-token` 无效/过期 → 重新获取{insert_element_9_}
- `28001018`: 应用**未开通**对应接口权限 → 控制台申请{insert_element_10_}
- `28003017`: 调用额度用尽 → 联系平台提升配额{insert_element_11_}

---

要不要我帮你整理一份可直接运行的 **Python 调用示例**（包含关键词搜索 + 详情查询）？

审核编辑 黄宇