> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 想研究公众号的视频和贴图，怎样分栏建目录并选案例？

> 说明公众号列表 page_size 被忽略、offset 的真实类型，以及 item_show_type 的文章、视频、音频、图文取值。

每个主页栏目单独建一份目录，都用 `wechat_mp.v2.fetch_account_articles`：传已核对的公众号 `username`，`item_show_type:5` 取**视频栏**，`8` 取**贴图栏**，每栏从空 `offset` 开始，再用本栏返回的 `data.next_offset` 续页。`wechat_mp.v2.fetch_account_articles` 会忽略 `page_size`，条数按实际收到的条目计。选案例时按真实发布日期筛，并打开原作品确认内容。只知道昵称时，先[从一篇公开文章核对账号](/zh/faq/wechat-account-identifier)。

## 先取一页视频，再用同样的方式取贴图

```bash
curl -sS https://api.beatapi.io/v1/social-data/call \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"action":"wechat_mp.v2.fetch_account_articles","params":{"username":"<username>","item_show_type":5,"raw":false,"offset":""}}' \
  -o wechat-videos-page-1.json
```

取贴图时将 `item_show_type` 改成 `8`。需要文章用 `0`，音频用 `7`。文章、视频、音频和贴图都是公众号主页的栏目。要研究[独立的视频号账号](/zh/guides/wechat-channels-video-inventory)，从视频号标识开始。

## 同一栏目怎样继续翻页？

1. 检查调用成功。`raw:false` 时，从 `data.articles` 保存标题、原文链接和发布时间，记录实际返回条数。
2. 仍有下一页时，把本栏返回的 `data.next_offset` 原样传给下一次 `offset`。账号、`item_show_type` 取值和 `raw` 设置保持不变。遇到 `data.is_end`、游标缺失或重复、调用失败或达到页数上限时停止。
3. 每栏要整理 50 条，就按实际返回的条目去重和计数。`wechat_mp.v2.fetch_account_articles` 会忽略 `page_size`。没到 50 条就停下时，写清去重后有多少条、翻了几页、为什么停止。

例如团队要找上月的产品演示和活动海报，第一轮视频栏取到 12 条、贴图栏取到 8 条。视频栏和贴图栏的数量分开记录，两份清单都按真实发布日期筛出上月候选，再打开原作品确认每条讲了什么。页数预算先用完时，注明哪些日期还没查到。每栏先取一页是两次请求，每多翻一页多一次请求。[BeatAPI 价格页](https://beatapi.io/zh/pricing)

## 从已保存的响应导出两份清单

用[历史文章指南](/zh/guides/wechat-account-articles)里的 `wechat_history.py`。一份请求清单固定 `item_show_type:5`，另一份固定 `item_show_type:8`。两份清单的首请求都传空 `offset` 和 `raw:false`。每次调用都保留实际 HTTP 状态、采集时间和响应文件。

```bash
python3 wechat_history.py - video-pages.json videos-001
python3 wechat_history.py - image-pages.json images-001
```

续批时传入该栏目自己的 `next-request.json` 和输出目录；开始新栏目时传 `-`。数量和停止原因看 `coverage.json`，栏目当前清单看 `state.json`，新增条目看 `new-articles.csv`。导出表只有作品元信息；要看视频或读贴图，打开原作品。