Finewisdom API Hub
首页 › 数据接口 › 视频号 › channels_search_videos

视频号搜索接口channels_search_videos

channels_search_videos 是 Finewisdom 的视频号搜索接口:搜索视频号视频(关键词,非号内搜索;支持排序/发布时间/时长筛选)。单价 ¥0.2 / 次,成功才计费,注册赠 20 次。

注册领 20 次免费额度catalog.jsonMCP

参数

参数说明约束
keyword搜索关键词(1-100 字)必填
sort排序:default/latest/hot可选
publish_time时间:all/day/week/half_year可选
duration时长:all/short/medium/long可选
cursor翻页游标(首页留空)可选
offset服务端偏移(仅首页传 0)可选
rawtrue=原始响应;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,不要混用。

同平台其他接口

channels_post_comments¥0.2获取视频号作品评论channels_post_detail¥0.3获取微信视频号作品详情channels_search_in_channel¥0.3在视频号账号内搜索作品channels_sub_comments¥0.2获取视频号评论的回复channels_user_info¥0.3获取视频号账号资料channels_user_posts¥0.3获取视频号账号作品列表