WeChat Video Search

20.65 credits/call
ae_wechat_video_search

Search WeChat Channels videos by keyword and narrow the results by duration, publication time, or sort order. Inputs (inside the required request_body object): - keyword: Required; 1–100 characters after trimming whitespace. - duration: Optional; all/0 (default), short/1 (under 5 minutes), medium/2 (5–10 minutes), or long/3 (20 minutes or more). - sort: Optional; default/0 (relevance; default), latest/1 (newest first), or hot/2 (most liked first). - publish_time: Optional; all/0 (default), day/1 (past day), week/2 (past seven days), or half_year/3 (past six months). - The three filter/sort fields accept either the listed string keys or integer codes; unsupported values are rejected. - offset: Optional nonnegative integer, default 0. Use 0 for the first page; changing offset alone does not retrieve further pages. - cursor: Omit for the first page. To continue, send the previous response's cursor unchanged and repeat the same duration, sort, and publish_time settings. - raw: Optional boolean, default true. true returns the original search response; false requests simplified parsing. Returns video search results directly. The result structure varies with raw. Search entries contain video identifiers such as exportId and jumpInfo.extInfo.feedNonceId rather than media download URLs or decode keys. Media details require a separate video-detail lookup using exportId. This tool does not search official accounts or download videos. Responses may be slow; use a 30-second client request timeout where configurable. Preserve large IDs such as docID and feedNonceId as strings with lossless JSON handling; JavaScript Number can change their digits.

VideoSocial
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.65 credits/call

20.65 credits/call Charges are per query. A successful query is billed even if it returns no results.

Fetching another page requires a separate call, charged individually.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes视频号视频搜索请求体对象,包含必填的搜索关键词 keyword,以及可选的时长筛选 duration、排序 sort、发布时间筛选 publish_time、分页参数 offset 和 cursor、原始或精简结果开关 raw。/Request body object for WeChat Channels video search, containing the required search keyword (keyword) and optional duration filter (duration), sort order (sort), publication-time filter (publish_time), pagination parameters (offset and cursor), and raw or simplified result selection (raw).—
request_body.rawbooleanNoTrue=原始搜索响应;False=精简解析结构/True=raw search response; False=simplified parsed structuretrue
request_body.sortinteger | stringNo排序:不限(相关性) default/0 / 最新(发布时间降序) latest/1 / 最热(点赞降序) hot/2,字符串键或整数均可/Sort: default/0 (relevance) / latest/1 (newest) / hot/2 (most liked); string key or integerdefault
request_body.cursorstring | nullNo翻页游标,用法同综合搜索:首页留空;翻页时把上一页响应返回的 cursor 原样传回/Pagination cursor, same as universal search: leave empty for the first page; pass back the cursor from the previous response—
request_body.offsetintegerNo首页传 0;翻页请用 cursor(只传 offset 无效)/Pass 0 for the first page; use cursor to paginate (offset alone does not work)0
request_body.keywordstringYes搜索关键词(1-100 字)/Search keyword (1-100 chars)—
request_body.durationinteger | stringNo时长档(video 垂类专属):不限 all/0 / 短(<5min) short/1 / 中(5-10min) medium/2 / 长(20min+) long/3,字符串键或整数均可/Duration tier (Channels video only): all/0 / short/1 (<5min) / medium/2 (5-10min) / long/3 (20min+); string key or integerall
request_body.publish_timeinteger | stringNo发布时间:不限 all/0 / 最近一天 day/1 / 最近七天 week/2 / 最近半年 half_year/3,字符串键或整数均可/Publish time: all/0 / day/1 / week/2 / half_year/3; string key or integerall

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_wechat_video_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "keyword": "装企管理",
      "raw": false
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "detail": {
    "code": 400,
    "docs": "https://api.tikhub.io/#/WeChat-Search-V2-API/fetch_search_videos_api_v1_wechat_search_v2_fetch_search_videos_post",
    "headers": {},
    "message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
    "message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
    "params": {
      "cursor": null,
      "duration": "all",
      "keyword": "装企管理",
      "offset": 0,
      "publish_time": "all",
      "raw": false
    }
  }
}

This example shows part of the response. Copied content is valid JSON.