# How do I export every video from a WeChat Channels account?

> Pull every video a WeChat Channels (视频号) account has posted, with likes, comments, shares and saves, into a spreadsheet. Getting the account ID, handling pinned videos, and the cost per account.

Canonical page: https://okdata.online/answers/wechat-channels-export-account-videos/

**Short answer: **Turn the account name into its v2_…@finder account ID with WeChat Channels account search ($0.02), then page through WeChat Channels account videos, newest first, about 15 a page for $0.02, each with likes, comments, shares and saves. The account profile gives the video count; an account with 300 videos takes 20 pages, $0.40.

WeChat Channels (视频号) is WeChat's short-video feed, and brands in China run accounts there next to their Official Accounts. To study one, which videos did well, how often it posts, what it keeps talking about, you want every video in one sheet with its date and engagement. Channels profiles have no web page and the app only lets you scroll. The account videos endpoint returns an account's videos page by page, newest first, until there are none left.

## The calls

1. **Get the account ID.** [WeChat Channels account search](/apis/wechat_channels/users/search/) finds an account by name and returns its ID, a string starting with `v2_` and ending in `@finder`. The short `sph…` ID shown in the app is a different identifier and the endpoints do not accept it. If you have any video from the account, [video detail](/apis/wechat_channels/videos/get/) returns the same ID as `author.id`.
2. **Check the size.** [Account profile](/apis/wechat_channels/users/get/) returns the name, bio and `posts`, the number of videos, which tells you how many pages to expect.
3. **Page through the videos.** Pass the account ID to [WeChat Channels account videos](/apis/wechat_channels/users/videos/list/). Each page holds about 15 videos with the numeric video ID, description, time posted, likes, comments, shares and saves. Send `page.next_cursor` back as `cursor` until `page.has_more` is false. URL-encode the account ID; the `@` must survive.

## A real run

On November 20, 2026 we exported the start of 瑞幸咖啡 (Luckin Coffee)'s official account. The profile returned `posts: 3085`, with followers and total likes null. The first page held 15 videos, and the first two were pinned: one from June 2026 and one from March 2025. Strict newest-first order started at the third. The second pinned video:

```json
{
  "id": "14604223065042978940",
  "title": "和刘亦菲一起鲜萃轻轻茉莉",
  "published_at": "2025-03-02T23:44:16.000Z",
  "metrics": { "likes": 65902, "comments": 2095, "shares": 26348, "favorites": 97802 }
}
```

The newest video on the same page was a day old, with 49 likes and 4 comments.

## Cost per account

| Videos on the account | Calls | Cost |
|---|---|---|
| 60 | 4 | $0.08 |
| 300 | 20 | $0.40 |
| 3,085 (Luckin above) | 206 | $4.12 |

Finding the ID and reading the profile add $0.04, once per account. For a weekly refresh, fetch page one and stop at the first video ID you already have.

## Script

```python
import os, requests

URL = "https://api.okdata.online/v1/wechat_channels/users/videos/list"
HEAD = {"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}
params, rows = {"id": "v2_…@finder"}, []   # the account ID to export

while True:
    body = requests.get(URL, headers=HEAD, params=params, timeout=60).json()
    for v in body["data"]["items"]:
        m = v["metrics"]
        rows.append((v["id"], v["published_at"], m["likes"], m["comments"], m["shares"], m["favorites"], v["text"]))
    if not body["page"]["has_more"]:
        break
    params["cursor"] = body["page"]["next_cursor"]
print(len(rows), "videos")
```

## Gotchas

- **Pinned videos come first.** The first few items can be old. In an incremental update, skip the pinned ones before you stop at a known ID.
- **No views.** WeChat does not publish play counts for Channels, so `metrics.views` is null. Many accounts also hide followers and total likes.
- **Cursors last 24 hours.** If a large account takes several days, start again from the top and de-duplicate by video ID.
- **Pin down one account ID.** Names repeat. Check the name and verifying organisation from search once, then reuse the stored ID.

## Related

- The comments under these videos: [How do I export comments from WeChat Channels videos?](/answers/wechat-channels-export-comments/)
- Finding videos by keyword: [How do I search WeChat Channels videos by keyword and get their views, likes and comment counts?](/answers/wechat-channels-video-search-likes-comments/)
- A costed walkthrough: [WeChat Channels account videos guide](/guides/wechat-channels-user-videos/)
- Tracking several competitors every week: [competitor monitoring](/solutions/competitor-monitoring/)

## Endpoints used

- [WeChat Channels account search](https://okdata.online/apis/wechat_channels/users/search/) `wechat_channels.users.search`: $0.02 per call · about 1 accounts per page
- [WeChat Channels account profile](https://okdata.online/apis/wechat_channels/users/get/) `wechat_channels.users.get`: $0.02 per call
- [WeChat Channels account videos](https://okdata.online/apis/wechat_channels/users/videos/list/) `wechat_channels.users.videos.list`: $0.02 per call · about 15 videos per page

## More about WeChat Channels

- [WeChat Channels API](https://okdata.online/apis/wechat_channels/)
- [How to export WeChat Channels video comments and replies](https://okdata.online/guides/wechat-channels-video-comments/)
- [WeChat Channels API in Python: videos and comments (2026)](https://okdata.online/guides/wechat-channels-api-python/)
- [How to get every video a WeChat Channels account has posted](https://okdata.online/guides/wechat-channels-user-videos/)
- [What is a WeChat Channels account ID (v2_…@finder), and why doesn't the sph ID work?](https://okdata.online/answers/wechat-channels-finder-id/)
- [How do I export comments from WeChat Channels videos?](https://okdata.online/answers/wechat-channels-export-comments/)
- [How do I search WeChat Channels videos by keyword and get their views, likes and comment counts?](https://okdata.online/answers/wechat-channels-video-search-likes-comments/)
- [Profile API](https://okdata.online/roles/accounts-get/)
- [Account posts API](https://okdata.online/roles/accounts-posts-list/)
- [Account search API](https://okdata.online/roles/accounts-search/)

## Sources

Where people asked this (read 2026-11-20): 

- https://developers.weixin.qq.com/community/develop/doc/000e42d1758608724f125fd296b800
- https://developers.weixin.qq.com/community/develop/doc/000080cf5c46f8fa029298f7066800
- https://www.52pojie.cn/thread-2054911-1-1.html

Updated 2026-11-20
