WeChat Search Channel Videos

20.65 credits/call
ae_wechat_search_channel_videos

Search a specific creator's published WeChat Channels videos by keyword. The search is limited to that account, and each call returns one page. Inputs inside the required request_body: - username (required): the creator's finder username, matching ^v2_[0-9a-fA-F]+@finder$, 10–256 characters. A display name is not a substitute. - keyword (required): the search text, 1–100 characters after trimming whitespace. - raw (optional, default true): true returns the raw grouped search response; false returns a simplified, flat hit list. - cursor (optional): omit or leave empty for the first page. For subsequent pages, copy the previous response's next_cursor exactly. It is an opaque string of at most 4096 characters; null is also accepted. Do not parse, concatenate, or construct it. Results: - With raw=false, data contains username and keyword echoes, count (hits on this page), items, continue_flag, and next_cursor. Each item includes type, doc_id, and title with search highlighting removed; desc, thumb_url, username, and nickname may be null. - With raw=true, data.query echoes the keyword, data.offset is the next-page offset, and hits are nested under data.data[N].subBoxes[M].items or data.data[N].items. The continuation field is data.continueFlag, rather than data.continue_flag. - Both formats provide data.next_cursor. Request another page only when the continuation flag is 1 and next_cursor is non-empty, passing it verbatim as cursor. next_cursor is null when there is no next page. Keep 64-bit IDs such as doc_id lossless by handling them as strings with an appropriate JSON parser; do not pass them through JavaScript Number. This tool returns search hits, not media download URLs or decoding keys; those require a separate video-detail lookup. Responses may be slow, so set a 30-second client timeout where configurable; timeout is not an input parameter.

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.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes号内视频搜索请求体对象:username 指定创作者的 finder username,keyword 指定在该账号内搜索的关键词;可选 raw 控制返回原始搜索响应或精简解析结构,可选 cursor 用于原样传入上一页返回的 next_cursor 以获取下一页,首页留空。/Request body object for searching videos within one creator's channel: username identifies the creator's finder account and keyword supplies the search text; optional raw selects the raw response or simplified parsed structure, and optional cursor passes the previous response's next_cursor verbatim to retrieve the next page. Leave cursor empty for the first page.—
request_body.rawbooleanNoTrue=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structuretrue
request_body.cursorstring | nullNo翻页游标:首页留空;翻页时原样回传上一页响应的 next_cursor(不透明字符串,勿解析或拼接)/Pagination cursor: leave empty for the first page; pass back the previous response's next_cursor verbatim (opaque string, do not parse or concatenate)—
request_body.keywordstringYes在该号内搜索的关键词(1-100 字)/Keyword to search within this channel (1-100 chars)—
request_body.usernamestringYes创作者 finder username(v2_…@finder 格式)/Creator finder username (v2_…@finder format)—

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_search_channel_videos' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "keyword": "白银",
      "raw": false,
      "username": "v2_060000231003b20faec8c6e4811bc2dcc607ed3cb0775be8a7a43cf8b91bd5ecb8fddcf6701d@finder"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "continue_flag": 1,
    "count": 20,
    "debug_id": "6ccf363e",
    "debug_info": "gAAAAABq7TTL1ecyoW91tacITeYGy43jjiWJdosAC5iCPiFafPWkj9R_Sd4P8a6-JmptwQjnI21xTS9CWaFIqh1RN6Qi8iFzjR93xpz9AKAAwgxvgA6BHwgXfgRRdzsJJ-4fMbVBhx-hXiE3aiFhWTf_7TBSLpLgNk43nLEi86fwf27UFKQJj2t79pR8W7kh66pcx_ypd90hLZdL0GvbSKZa4pjWPo7J8iZSnPLmNz_RdAuVdMmznjN-FLn0NWhx",
    "items": [
      {
        "doc_id": "finderobjv0akW4jKOhtimUO90tIsBRc1wb3fmajYAmiwz7c09kTYU=",
        "title": "#互换便利 #回购再贷款 #SFISF #央行 #股市",
        "type": "video"
      }
    ],
    "keyword": "白银"
  },
  "docs": "https://api.tikhub.io/#/WeChat-Channels-V2-API/fetch_search_channel_videos_api_v1_wechat_channels_v2_fetch_search_channel_videos_post",
  "message": "Request successful. This request will incur a charge."
}

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