视频号搜索接口channels_search_videos
channels_search_videos 是 Finewisdom 的视频号搜索接口:搜索视频号视频(关键词,非号内搜索;支持排序/发布时间/时长筛选)。单价 ¥0.2 / 次,成功才计费,注册赠 20 次。
参数
| 参数 | 说明 | 约束 |
|---|---|---|
keyword | 搜索关键词(1-100 字) | 必填 |
sort | 排序:default/latest/hot | 可选 |
publish_time | 时间:all/day/week/half_year | 可选 |
duration | 时长:all/short/medium/long | 可选 |
cursor | 翻页游标(首页留空) | 可选 |
offset | 服务端偏移(仅首页传 0) | 可选 |
raw | true=原始响应;false=精简结构(默认 false) | 可选 |
调用示例
把 token 换成你的即可,所有参数走 query string。
GET https://finewisdom.top/api?token=fw_xxx&method=channels_search_videos&keyword=搜索关键词(1-100字)&sort=排序:default/latest/hot&publish_time=时间:all/day/week/half_year&duration=时长:all/short/medium/long&cursor=翻页游标(首页留空)&offset=服务端偏移(仅首页传0)&raw=true=原始响应;false=精简结构(默认false)
Python 调用
import requests
resp = requests.get(
"https://finewisdom.top/api",
params={"token": "fw_xxx", "method": "channels_search_videos", "keyword": "...", "sort": "...", "publish_time": "...", "duration": "...", "cursor": "...", "offset": "...", "raw": "..."},
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.2 / 次,只在 status=success 时扣费;失败、超时、空结果都不计费。限流 1 次/秒/IP,超出返回 429。
新用户注册赠 20 次免费调用,余额不过期。
常见问题
这个接口调用失败会扣钱吗?
不会。返回 status=error 或 api_error 时不计费,预扣的额度会自动退回。只有当 status=success 才算一次成功调用。
单价多少,怎么计费?
¥0.2 / 次,按成功调用次数计费,没有月费、没有最低消费。翻页每翻一页各算一次调用。
怎么翻页?
用 cursor 传上一页返回的游标(不传等于取第一页)。注意社媒类接口用游标翻页,电商类多用 page,不要混用。