POST /v1/douyin/search/fetch_general_search_v3
获取综合搜索 V3
stable · 13 credits / 次（成功才计）
获取抖音综合搜索结果（V3 版本），返回视频、用户、相关搜索词等混合卡片。；相比 V1/V2 不支持排序与筛选条件，但翻页参数更简单，响应结构统一（`config` + `items` + `pagination`）。；备注；首次请求 `offset` 传 0、`page` 传 1，`search_id` 与 `backtrace` 传空字符串。；翻页时把上一次响应 `data.pagination` 里的 `offset`、`search_id`、`backtrace` 原样传回，并把 `page` 加 1。；`data.pagination.has_more` 为 0 表示已经到最后一页。；每页固定 10 条，不支持指定数量。`page` 上限为 200，超出会返回参数错误。；keyword: 搜索关键词，如 "猫咪"；offset: 翻页游标（首次请求传 0）；page: 页码，取…
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
| page | integer | body | 否 | 页码，取值 1~200，首次请求传 1，之后每次加 1 | demo |
| offset | integer | body | 否 | 翻页游标，从上一次响应的 data.pagination.offset 获取，首次请求传 0 | demo |
| keyword | string | body | 否 | 搜索关键词 | 咖啡 |
| backtrace | string | body | 否 | 翻页回溯标识，从上一次响应的 data.pagination.backtrace 获取，首次请求传空字符串 | demo |
| search_id | string | body | 否 | 搜索ID，从上一次响应的 data.pagination.search_id 获取，首次请求传空字符串 | demo |
响应字段
字段字典待补 —— 右侧可执行区可直接看到真实结构。
错误码
| code | HTTP | 含义 | 是否计费 |
|---|---|---|---|
| 40001 | 400 | 参数缺失或格式错误 | 否 |
| 40102 | 401 | API Key 无效或已吊销 | 否 |
| 40201 | 402 | 余额不足，请充值 | 否 |
| 40402 | 404 | 目标资源不存在 | 否 |
| 42201 | 422 | 质量门槛未通过 | 否 |
| 42901 | 429 | 超出速率限制 | 否 |
| 50401 | 504 | 上游超时 | 否 |
| 50201 | 502 | 上游返回异常 | 否 |
计费
成功扣 13 credits；任何失败（含上游 200 但未过质量门槛）扣 0。