WeChat Get Collection Videos

20.65 credits/call
ae_wechat_get_collection_videos

## Purpose List videos in a known WeChat Channels collection, including video metadata, engagement counts, media references and pagination information. Each call returns one page, not necessarily the entire collection. ## Inputs Provide a required `request_body` object: - `topic_id` (required): digits-only collection ID as a string, at most 32 characters. Obtain it from a collection listing; for example, `"14616794565351966924"`. - `topic` (optional): collection name, up to 100 characters, to improve matching. - `username` (optional): creator finder username in `v2_<hexadecimal characters>@finder` format, up to 256 characters, to improve matching. - `topic_type` (optional): integer from 0 to 1000, default `16`. Use the type reported for the collection. - `last_buffer` (optional): base64 pagination cursor. Leave empty for the first page; pass the previous response's cursor unchanged for the next page. - `raw` (optional): defaults to `true` for the full original response. Set to `false` for simplified data, recommended for media handling. The optional text fields default to empty strings and also accept null. A name or username does not replace the required collection ID. ## Results and pagination With `raw=false`, `data` contains: - `topic_id` and `title`: collection identity and name. - `total_count`: total videos in the collection; `count`: items in the current page. - `videos[]`: video ID, creator username and nickname, title (which may be null), creation time, view/like/favorite/share/comment counts, and a `media` object. Media fields include `url`, `url_token`, `full_url`, `decode_key`, cover URL, duration, dimensions and media type. - `down_continue`: whether another page is available (`1` means yes); `last_buffer`: cursor for that page. With `raw=true`, videos are in `data.object[]`, the total is `data.totalCount`, and media fields are under `data.object[N].objectDesc.media[0]` as `url`, `urlToken` and `decodeKey`. Use `data.downContinueFlag` for collection pagination, not `continueFlag`. The cursor is `data.lastBuffer` (also documented as `data.last_buffer`); pass it as the next request's `last_buffer`. ## Important notes - Keep collection and video IDs as strings. Response IDs may exceed JavaScript's safe-integer range; use precision-safe JSON parsing and never convert them through JavaScript `Number`. - For media downloads, prefer the simplified `media.full_url`, which combines `url` and `url_token`. With raw data, concatenate `url` and `urlToken`. The bare URL may fail because of access-token requirements. - If a video is encrypted, decrypt it separately with the key from the same response. Keys change with each request. This tool does not download or decrypt files. - Responses may be slow; a 30-second client request timeout is recommended.

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查询指定微信视频号合集内视频的请求体对象。topic_id 为必填的合集 ID;可选的 topic、username 和 topic_type 用于补充合集名称、创作者用户名和合集类型,last_buffer 用于翻页(首页留空),raw 用于选择原始响应或精简解析结构。/Request body object for listing videos in a specified WeChat Channels collection. topic_id is the required collection ID; optional topic, username and topic_type provide the collection name, creator username and collection type, last_buffer controls pagination (leave empty for the first page), and 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.topicstring | nullNo合集名(可选,提高命中)/Collection name (optional, improves hit rate)""
request_body.topic_idstringYes合集 ID(纯数字,来自 fetch_user_collections 的 topic_id)/Collection ID (numeric, from topic_id of fetch_user_collections)—
request_body.usernamestring | nullNo创作者 finder username(可选,提高命中)/Creator finder username (optional, improves hit rate)""
request_body.topic_typeintegerNo合集类型,默认 16(与 fetch_user_collections 返回的 topic_type 对齐)/Collection type, default 16 (align with topic_type from fetch_user_collections)16
request_body.last_bufferstring | nullNo翻页游标(base64),首页留空/Pagination cursor (base64), leave empty for first page""

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

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_collection_videos' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "topic_id": "14616794565351966924"
    }
  }
}'

No response example available yet.