Finewisdom API Hub
Home › API Reference › WeChat Channels › channels_search_videos

WeChat Channels search API channels_search_videos

channels_search_videos is the Finewisdom WeChat Channels search API (method channels_search_videos). ¥0.2 CNY per successful call, 20 free calls on signup, billed only on success.

Get 20 free callscatalog.jsonMCP

Parameters

ParameterDescriptionRequired
keywordSearch keywordrequired
sortSort: default/latest/hotoptional
publish_timeTime range: all/day/week/half_yearoptional
durationLength filter: all/short/medium/longoptional
cursorPagination cursoroptional
offsetPagination offset (0 on the first page)optional
rawtrue = raw upstream response; false = normalized (default)optional

Request example

Replace the token with yours. All parameters go in the query string.

GET https://finewisdom.top/api?token=fw_xxx&method=channels_search_videos&keyword={keyword}&sort={sort}&publish_time={publish_time}&duration={duration}&cursor={cursor}&offset={offset}&raw={raw}

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"])  # failed calls are not charged

Response envelope

Every call returns the same envelope. Billing only happens when status is success.

{
  "status": "success",
  "message": "...",
  "data": { ... }
}

Only the envelope is shown. Fields inside data depend on the platform response — inspect one real call before writing a parser.

A token is generated when you sign up in the console (format fw_xxx). Never commit it to a repo or write it to logs.

Pricing & rate limit

¥0.2 CNY per successful call. Failed calls, timeouts and empty results are never charged. Rate limit: 1 request/second/IP (HTTP 429 beyond that).

New accounts get 20 free calls. Balance never expires.

FAQ

Do failed calls cost anything?

No. Calls returning status=error or api_error are not charged, and any pre-authorised amount is refunded automatically. Only status=success counts as a billable call.

How much does one call cost?

¥0.2 CNY per successful call. No subscription, no minimum spend. Each page of results is a separate call.

How do I paginate?

Pass cursor with the cursor returned by the previous page (omit it for the first page). Social endpoints paginate by cursor; e-commerce endpoints usually use page. Do not mix the two.

More WeChat Channels endpoints

channels_post_comments¥0.2Channels post commentschannels_post_detail¥0.3Channels post detailchannels_search_in_channel¥0.3Channels search in channelchannels_sub_comments¥0.2Channels sub commentschannels_user_info¥0.3Channels user infochannels_user_posts¥0.3Channels user posts