WeChat Get Live History
## Purpose List a WeChat Channels creator's live replays, one page at a time, with video metadata and media URLs. The tool returns information for downloading and decrypting replay videos; it does not download or decrypt them itself. ## Inputs Provide a `request_body` object containing: - `username` (required): the creator's finder identifier, in `v2_<hexadecimal characters>@finder` format, 10–256 characters. A display name is not a substitute. - `last_buffer` (optional): base64 pagination cursor; defaults to an empty string and also accepts null. Leave empty for the first page. For subsequent pages, use the cursor returned by the previous page when its continuation flag indicates more results. - `flag` (optional): fetch flag, an integer from 0 to 1000; default `12`. - `raw` (optional): defaults to `true` for the original response. Set to `false` for a simplified structure, recommended for media handling. ## Results For `raw=false`, `data.lives[]` contains replay video objects with IDs, creator information, titles, creation times, engagement counts, and a single `media` object. `data.count` is the number of items on this page; `data.total_count` is the total replay count, or `0` when none exist. `data.continue_flag` indicates whether another page is available (`1` means yes), and `data.last_buffer` is the next-page cursor. The simplified media fields are `url`, `url_token`, `full_url` (the URL with token already appended), and `decode_key`. For `raw=true`, replays are in `data.object[]`, total count in `data.totalCount`, continuation in `data.continueFlag`, and the cursor in `data.lastBuffer` (also documented as `data.last_buffer`). Raw media is at `data.object[N].objectDesc.media[0]`, using `url`, `urlToken`, and `decodeKey`; construct the full URL by concatenating `url` and `urlToken`. ## Handling notes Use the decryption key from the same response as the media URL; keys change between requests. Preserve large 64-bit IDs as strings with lossless JSON parsing, not JavaScript `Number`. Responses may be slow; configure a 30-second timeout in the calling client, not as a tool argument.
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 标识;last_buffer 用于翻页,首页留空,有下一页时传入上一页返回的游标;flag 为拉取标志;raw 控制返回原始响应或精简解析结构。/Request body for listing a creator's live replays: username identifies the creator by finder username; last_buffer is the pagination cursor, left empty for the first page and set to the previous response's cursor when more pages are available; flag is the fetch flag; raw selects the original response or simplified parsed structure. | — |
request_body.raw | boolean | No | True=原始响应;False=精简解析结构(推荐做媒体下载)/True=raw response; False=simplified parsed structure (recommended for media download) | true |
request_body.flag | integer | No | 拉取标志,默认 12/Fetch flag, default 12 | 12 |
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_live_history' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"raw": false,
"username": "v2_060000231003b20faec8c4e3881cc3d1cb00eb34b0773f8d9e24b60cc5f36f1e532736f5b8f7@finder"
}
}
}'{
"code": 200,
"data": {
"continue_flag": 0,
"count": 0,
"debug_id": "ac4e9447",
"debug_info": "gAAAAABq7aBOK142HH63MjdpVLjUSfl8QtjcEiDmuBMP6x4ZLevHGEgETW34EgJlUXQOEa3erIwn3cdP4RJZKk2fz4Op2jDMqUC2TqMUMwbbiI8YsnEhmCcyv6gtoV52I8PUa27nSvETr5GsO5kaN4N3of5TYjMfq5mIfN44KDf7v_fxyp2per6tIdLOaVIBb25izem3rZhCiAJ5pReNMxT7TfQYTPED9xQ_mtJvsTz_P25YVUk2yHpuzkgk3Q1R",
"last_buffer": "CP///////////wEQAQ==",
"total_count": 0
},
"docs": "https://api.tikhub.io/#/WeChat-Channels-V2-API/fetch_live_history_api_v1_wechat_channels_v2_fetch_live_history_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.






