WeChat Get Live History

20.65 credits/call
ae_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.

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 标识;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.rawbooleanNoTrue=原始响应;False=精简解析结构(推荐做媒体下载)/True=raw response; False=simplified parsed structure (recommended for media download)true
request_body.flagintegerNo拉取标志,默认 12/Fetch flag, default 1212
request_body.usernamestringYes视频号 finder username(v2_…@finder 格式)/WeChat Channels finder username (v2_…@finder format)—
request_body.last_bufferstring | nullNo翻页游标(base64),首页留空/Pagination cursor (base64), leave empty for first page""

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_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"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.