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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 号内视频搜索请求体对象: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.raw | boolean | No | True=原始响应;False=精简解析结构/True=raw response; False=simplified parsed structure | true |
request_body.cursor | string | null | No | 翻页游标:首页留空;翻页时原样回传上一页响应的 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.keyword | string | Yes | 在该号内搜索的关键词(1-100 字)/Keyword to search within this channel (1-100 chars) | — |
request_body.username | string | Yes | 创作者 finder username(v2_…@finder 格式)/Creator finder username (v2_…@finder format) | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}
}'{
"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.






