WeChat Get User Videos
## Purpose Retrieve a page of videos posted on a specified WeChat Channels account, with video metadata, engagement counts, media links and pagination information. This tool returns data and links; it does not download or decrypt video files. ## Inputs Supply a `request_body` object containing: - `username` (required): the account's finder username, in `v2_…@finder` format with hexadecimal characters between the prefix and suffix; 10–256 characters. Use the finder username, not the account's display name or a video ID. - `last_buffer` (optional; default `""`): a base64 pagination cursor. Omit it or leave it empty for the first page. For subsequent pages, pass the previous response's cursor unchanged when the continuation flag indicates more results. - `raw` (optional; default `true`): `true` returns the raw structure; `false` returns a simplified structure recommended for media processing. ## Results With `raw=false`, `data` contains `username`, `nickname`, `count` (the number of videos on this page), `up_continue`, `last_buffer` and `videos[]`. Each video includes identifiers, title, account information, view/like/favorite/share/comment counts, publish time, location and a `media` object. The media fields are `url`, `url_token`, `full_url` (the combined download URL) and `decode_key`. With `raw=true`, the video array is `data.object[]` (singular `object`). Pagination uses `data.upContinueFlag` and `data.lastBuffer`, with `data.last_buffer` also supplied as an alias. Account information appears in `data.contact` and `data.finderUserInfo`. Media is nested at `data.object[N].objectDesc.media[0]`, with `url`, `urlToken` and `decodeKey`. ## Important notes - Each call retrieves one page, not necessarily all videos. Continue only when the returned continuation flag indicates another page. - Preserve `id`, `object_nonce_id` and other 64-bit identifiers as exact strings through lossless JSON parsing. JavaScript `Number` can corrupt their precision. - Use `full_url`, or concatenate the media URL and its token, for downloading. A successful download does not guarantee a playable file: encrypted video requires separate decryption. Links and keys change on each request, so use the key and encrypted file from the same response. - Responses may be slow; configure the client request timeout to 30 seconds. This is a client setting, not an additional tool input.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
The fixed fee for each call is 20.65 credits. Charges are per query. A successful query is billed even if it returns no results.
Each call retrieves one page of posts from the specified WeChat Channels account. Fetching another page requires another call at the same fixed fee.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 用于分页获取指定微信视频号账号主页作品列表的请求体对象:username 指定账号的 finder username;last_buffer 为可选翻页游标,首页留空,有下一页时传入上一页返回的游标;raw 用于选择原始响应或精简解析结构。 | — |
request_body.raw | boolean | No | True=原始响应;False=精简解析结构(推荐做媒体下载)/True=raw response; False=simplified parsed structure (recommended for media download) | true |
request_body.username | string | Yes | 视频号 finder username(v2_…@finder 格式)/WeChat Channels finder username (v2_…@finder format) | — |
request_body.last_buffer | string | null | No | 翻页游标(base64),首页留空/Pagination cursor (base64), leave empty for first page | "" |
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_get_user_videos' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"last_buffer": "",
"raw": false,
"username": "v2_060000231003b20faec8c4e18d1cc4d6cd02e436b0771161ada39d3728cc0bd32953a3f45d05@finder"
}
}
}'{
"code": 200,
"data": {
"count": 0,
"debug_id": "fec5d73a",
"debug_info": "gAAAAABq9BY9QvfCcwEzil93Iidw3_Hg_NcztHn7gqqmA6Zkbk5taPe83pEytHe_fen98LfyV5fDEd-DyCEaCoMOe1qRr0iqcmzP2gKZKKF-y-bWBMfESbeJFxLzNZdE74ayS_K9Qeu7S9-kKBIW_OKLNvL4inLy1_Qi73sjLaOAYcyjteamfiY6QGx92nain4_wQ0PTAd2Fvb1AHrfj2P1T3X_II9qxu1nPGMaomzxAbOleHqBDqABvU1A4IKmF",
"last_buffer": "EAEYADAAOP2Py8Kv/5cDQP///////////wE=",
"nickname": null,
"up_continue": 0
},
"docs": "https://api.tikhub.io/#/WeChat-Channels-V2-API/fetch_user_videos_api_v1_wechat_channels_v2_fetch_user_videos_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"last_buffer": "",
"raw": false,
"username": "v2_060000231003b20faec8c4e18d1cc4d6cd02e436b0771161ada39d3728cc0bd32953a3f45d05@finder"
}
}This example shows part of the response. Copied content is valid JSON.






