抖音搜索接口douyin_keyword_search
douyin_keyword_search 是 Finewisdom 的抖音搜索接口:按关键词搜索抖音内容(综合搜索,返回视频列表)。每页约 25 条,单次实际返回 23~24 条;page>0 时服务端自动预热首页获取 search_id 完成翻页链(预热不计费);触发风控或无结果时返回 code:false 且不扣费,应按失败处理而非空数据。。单价 ¥0.1 / 次,成功才计费,注册赠 20 次。
参数
| 参数 | 说明 | 约束 |
|---|---|---|
keyword | 关键词 | 必填 |
page | 页码,内部 offset=page*25 | 可选 |
调用示例
把 token 换成你的即可,所有参数走 query string。
GET https://finewisdom.top/api?token=fw_xxx&method=douyin_keyword_search&keyword=关键词&page=页码,内部offset=page*25
Python 调用
import requests
resp = requests.get(
"https://finewisdom.top/api",
params={"token": "fw_xxx", "method": "douyin_keyword_search", "keyword": "...", "page": "..."},
timeout=60,
)
payload = resp.json()
if payload.get("status") == "success":
data = payload["data"]
else:
print(payload["message"]) # 失败不计费
返回结构
统一信封。status 为 success 才计费,失败 / 空结果不扣费。
{
"status": "success",
"message": "...",
"data": { ... }
}
示例只展示统一信封,data 内字段以实际返回为准——建议先用 1 次调用看结构,再写解析。
Token 在控制台注册后自动生成,形如 fw_xxx,不要写进代码仓库或日志。
计费与限流
单价 ¥0.1 / 次,只在 status=success 时扣费;失败、超时、空结果都不计费。限流 1 次/秒/IP,超出返回 429。
新用户注册赠 20 次免费调用,余额不过期。
常见问题
这个接口调用失败会扣钱吗?
不会。返回 status=error 或 api_error 时不计费,预扣的额度会自动退回。只有当 status=success 才算一次成功调用。
单价多少,怎么计费?
¥0.1 / 次,按成功调用次数计费,没有月费、没有最低消费。翻页每翻一页各算一次调用。
同平台其他接口
douyin_author_info¥0.1获取抖音作者详细信息douyin_author_search¥0.1获取抖音作者的作品(视频)列表,支持游标翻页douyin_product_comments¥0.2获取抖音商品评论列表douyin_product_detail¥0.3获取抖音商品详情douyin_product_detail_v2¥0.2获取抖音商品详情(native 通道,Cookie 池直连抖音)。原样返回抖音结构:status_code + promotion_h5(标题/价格/店铺券/SKU 都在 promotion_h5 内,字段与抖音同名同层,不做字段转换)。与 v1(yx2)、v3(EI) 是三种不同结构。douyin_product_detail_v3¥0.3获取抖音商品详情(EveryInfra 通道,字段已归一化)。返回标题、价格、优惠价、已售数、店铺、主图/详情图、规格组、服务保障、在售状态。上游走异步作业,通常 3-10 秒。douyin_product_keyword_search¥0.3按关键词搜索抖音商城商品(数据源 EveryInfra)。单次固定返回最多 5 条,暂不支持翻页;page>0 直接返回失败且不扣费douyin_shop_search¥0.3搜索抖音店铺商品douyin_video_comments¥0.2获取抖音视频的评论列表douyin_video_detail¥0.1获取抖音视频详细信息douyin_video_like_count¥0.1获取抖音视频点赞数douyin_video_play_count¥0.1获取抖音视频播放量