---
document_id: agent.collection.task.wechat_channel_collection_videos_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Collection videos / 合集视频

Fetch videos in a collection.

取合集内视频列表。

Task / 任务: `wechat_channel_collection_videos_v1`
Platform / 平台: WeChat Channels / 视频号
Billing / 计费: 3 Credits per successful task / 每个成功任务 3 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Limitations / 限制

- 只接受数字合集 topic_id。
- 支持翻页:把 next_cursor 原样传回 cursor。

## Inputs / 输入

- `collection_id` — Collection ID / 合集 ID; kind=text; required=True; default=''; bounds=min_length=1, max_length=32
- `topic` — Topic / 合集主题; kind=text; required=False; default=''; bounds=min_length=0, max_length=100
- `username` — Username / 用户名; kind=text; required=False; default=''; bounds=min_length=0, max_length=256
- `cursor` — Cursor / 翻页游标; kind=cursor; required=False; default=''; bounds=max_length=8192
- `topic_type` — Topic type / 主题类型; kind=integer; required=False; default=16; bounds=min=0, max=1000

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "获取合集内的视频列表",
  "task_code": "wechat_channel_collection_videos_v1",
  "input": {
    "collection_id": "14616794565351966924"
  }
}
```


## Result and pagination / 结果与分页

- mode=cursor
- input: `cursor`; continuation: `data.has_more` → `data.next_cursor`

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.items` — type=array<object>; Items returned by this page. / 本页返回的条目。
- `data.item_count` — type=integer; Number of items in this page. / 本页条目数。
- `data.has_more` — type=boolean; Whether another page is available and has a safe continuation token. / 是否还有下一页且已返回可安全使用的续页令牌。
- `data.next_cursor` — type=string|null; Continuation token to pass back to the same task when has_more is true. / has_more 为 true 时传回同一任务的续页令牌。
- `data.items[].id` — type=scalar|null; Id, when available. / ID（如有）。
- `data.items[].object_nonce_id` — type=scalar|null; Object nonce id, when available. / 对象随机标识ID（如有）。
- `data.items[].username` — type=scalar|null; Account username, when available. / 账号用户名（如有）。
- `data.items[].nickname` — type=scalar|null; Display name, when available. / 昵称（如有）。
- `data.items[].title` — type=scalar|null; Title, when available. / 标题（如有）。
- `data.items[].create_time` — type=scalar|null; Creation time, when available. / 创建时间（如有）。
- `data.items[].location` — type=scalar|null; Location, when available. / 地点（如有）。
- `data.items[].read_count` — type=scalar|null; Read count, when available. / 阅读数（如有）。
- `data.items[].like_count` — type=scalar|null; Like count, when available. / 点赞数（如有）。
- `data.items[].fav_count` — type=scalar|null; Fav count, when available. / 收藏数（如有）。
- `data.items[].forward_count` — type=scalar|null; Forward count, when available. / 转发数（如有）。
- `data.items[].comment_count` — type=scalar|null; Comment count, when available. / 评论数（如有）。
- `data.items[].media` — type=object|null; Public media summary, when available. / 公开媒体信息（如有）。
- `data.topic_id` — type=scalar|null; Topic id, when available. / 话题ID（如有）。
- `data.title` — type=scalar|null; Title, when available. / 标题（如有）。
- `data.total_count` — type=scalar|null; Total count, when available. / 总数（如有）。
- `data.count` — type=scalar|null; Result count, when available. / 结果数量（如有）。
- `data.items[].media.url` — type=scalar|null; Public URL, when available. / 公开链接（如有）。
- `data.items[].media.cover_url` — type=scalar|null; Cover url, when available. / 封面链接（如有）。
- `data.items[].media.duration` — type=scalar|null; Duration, when available. / 时长（如有）。
- `data.items[].media.width` — type=scalar|null; Width, when available. / 宽度（如有）。
- `data.items[].media.height` — type=scalar|null; Height, when available. / 高度（如有）。
- `data.items[].media.media_type` — type=scalar|null; Media type, when available. / 媒体类型（如有）。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。