...",
"contentMarkdown": "黄岩岛主权铁证如山，菲炒作徒劳！中国驻菲使馆：是我们的一寸也不能丢。\n\n南部战区新闻发言人表示...",
"images": ["https://mmbiz.qpic.cn/mmbiz_png/z8icaWS616QWM45I0WxpTNNibIbtc2y4u8l.../640?wx_fmt=png&from=appmsg"],
"videoIds": [],
"links": [],
"linkCount": 0,
"wordCount": 1476,
"characterCount": 1677,
"imageCount": 3,
"videoCount": 0,
"biz": "MjM5MDk1NzQzMQ==",
"mid": "2654110574",
"idx": "2",
"sn": null,
"isOriginal": true,
"searchKeyword": "环球时报",
"sourceUrl": "https://weixin.sogou.com/link?url=dn9a_-gY295K0Rci...",
"scrapedAt": "2026-10-13T14:36:11.000Z"
}
```
An account profile record from **Discover accounts by topic** (shortened):
```json
{
"recordType": "account",
"accountName": "企鹅吃喝指南",
"accountId": "qiechihe",
"description": "客观独立，亲身实测，专业严选，找遍来自全世界的好东西，和你分享...",
"latestArticleTitle": "咖啡界卷到尽头，是这。",
"latestPublishedAt": "2022-10-04T04:20:50.000Z",
"articlesInResults": 4,
"searchKeyword": "咖啡"
}
```
Download the dataset as JSON, CSV, Excel, XML or HTML from the Output tab or through the API. The **Articles** and **Accounts** views show the most-used columns.
### Use the WeChat Official Accounts Scraper API
With the [Apify API client for Python](https://docs.apify.com/api/client/python):
```python
from apify_client import ApifyClient
client = ApifyClient("
")
run = client.actor("parsebird/wechat-official-accounts-scraper").call(run_input={
"mode": "search",
"keywords": ["人工智能"],
"sortBy": "recent",
"maxItems": 50,
})
for article in client.dataset(run["defaultDatasetId"]).iterate_items():
print(article["publishedAt"], article["accountName"], article["title"])
```
With the [Apify API client for JavaScript](https://docs.apify.com/api/client/js):
```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '' });
const run = await client.actor('parsebird/wechat-official-accounts-scraper').call({
mode: 'account_search',
accounts: ['新能源汽车'],
maxItems: 20,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((a) => console.log(a.accountName, a.accountId, a.description));
```
See the [API tab](https://apify.com/parsebird/wechat-official-accounts-scraper/api) for HTTP endpoints, including a single call that runs the scraper and returns the dataset.
### Use cases
- **Media and brand monitoring.** Track what WeChat accounts publish about your brand, product or industry.
- **Market research in China.** Follow topics such as new energy vehicles, AI or consumer trends through the articles published about them.
- **Competitor and KOL research.** Find the Official Accounts active on a topic and read their latest articles.
- **Content archives and AI datasets.** Save articles as Markdown with images for search indexes, RAG pipelines or translation.
- **Academic research.** Collect public articles for text analysis of Chinese online media.
### How it works
1. Keywords and account names are searched on Sogou WeChat search, which indexes public Official Account articles. Sogou shows up to 10 pages of 10 results per query to visitors who aren't logged in.
2. Each result is opened on mp.weixin.qq.com, and the article page is parsed for its text, images, account details and identifiers.
3. For account history, only results published by the account with exactly that name are kept. For account discovery, results are grouped by account, and each account's latest article supplies its profile.
4. When Sogou starts refusing searches from one IP, the scraper switches to a new proxy IP and continues.
### FAQ
**Why are there at most 100 articles per keyword?**
Sogou shows 10 pages of results per query to visitors who aren't logged in, and its date filters also require a login. Add more specific keywords to collect more articles.
**Does account history return every article an account has published?**
No. It searches Sogou for the account's name and keeps the results published by that account, so it returns the indexed articles that appear in the first 100 results. For very widely quoted names, those 100 results can all come from other accounts that mention the name (in our tests, a search for 人民日报 returned no articles by 人民日报 itself). A full history needs the WeChat app, which this scraper does not use.
**Why does `articleUrl` look different for search results?**
Articles found through Sogou open on a signed `mp.weixin.qq.com/s?src=11×tamp=...&signature=...` link, because WeChat hides the permanent link (and `sn`) on pages reached from Sogou. These links worked for hours in our tests, but WeChat may expire them, so save the content you need. `biz`, `mid` and `idx` identify the article permanently. Links you paste yourself are kept as they are.
**Why is `sn` empty?**
WeChat doesn't include it on pages opened from Sogou. It is filled for article links that contain it.
**How long does a run take?**
About 1–2 minutes for 10 articles and 10–15 minutes for 100. Each article page is large (several MB), and Sogou limits how fast one IP can search, so the scraper paces itself and switches IPs as it goes.
**What happens with deleted articles?**
Articles deleted by the publisher or removed by WeChat are skipped, logged, and not charged.
**Does it need a WeChat account?**
No. It only reads public article pages and Sogou's public search results.
**Something doesn't work. What should I do?**
Open an issue on the **Issues** tab with your input and run link.
### Is it legal to scrape WeChat Official Account articles?
This scraper reads only public articles that anyone can open in a browser, and public search results. Articles are copyrighted by their publishers, and some contain personal data such as author names. Use the data for research, monitoring or analysis, respect copyright when republishing, and follow the laws that apply to you, including China's Personal Information Protection Law (PIPL) and the GDPR. Read more in Apify's blog post on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).
### Other scrapers by ParseBird
- [Made-in-China.com Scraper & API](https://apify.com/parsebird/made-in-china-scraper) – Chinese suppliers and products
- [Naver Blog & Cafe Scraper](https://apify.com/parsebird/naver-blog-cafe-scraper) – Korean blog and cafe posts
- [PR Newswire Scraper](https://apify.com/parsebird/pr-newswire-scraper) – press releases
- [Reddit Search Scraper](https://apify.com/parsebird/reddit-search-scraper) – Reddit posts by keyword
- [Facebook Group Posts & Comments Scraper](https://apify.com/parsebird/facebook-group-posts-comments-scraper) – posts and comments from public Facebook groups
# Changelog
This Actor's version history is a separate document: https://apify.com/parsebird/wechat-official-accounts-scraper/changelog.md
# Actor input Schema
## `mode` (type: `string`):
Auto runs every field you fill in: keywords as an article search, article links directly, and account names as account history. Pick a mode to run only one of them, or 'Discover accounts' to get account profiles for a topic.
## `keywords` (type: `array`):
Topics, brands, industries or phrases, one per line, in Chinese or English. Each keyword runs as its own article search.
## `articleUrls` (type: `array`):
Public mp.weixin.qq.com article links, such as https://mp.weixin.qq.com/s/xxxx or https://mp.weixin.qq.com/s?\_\_biz=...\&mid=...\&idx=...\&sn=...
## `accounts` (type: `array`):
For 'Articles from an account': the exact account name, such as 人民日报. For 'Discover accounts by topic': a topic, such as 人工智能.
## `sortBy` (type: `string`):
Relevance keeps Sogou's order. Newest first reads all available results and sorts them by publish time.
## `includeContent` (type: `boolean`):
Add the full article as plain text, HTML and Markdown.
## `includeImages` (type: `boolean`):
Add the cover image, account avatar and the image links inside the article.
## `maxItems` (type: `integer`):
Maximum number of articles (or account profiles in 'Discover accounts') to save in total.
## `maxConcurrency` (type: `integer`):
How many articles are opened in parallel.
## `proxyConfiguration` (type: `object`):
Sogou limits how many searches one IP can make, so the scraper changes IP when it is blocked. Apify Proxy (datacenter) works well.
## Actor input object example
```json
{
"mode": "auto",
"keywords": [
"人工智能"
],
"sortBy": "relevance",
"includeContent": true,
"includeImages": true,
"maxItems": 10,
"maxConcurrency": 6,
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"keywords": [
"人工智能"
],
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/wechat-official-accounts-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"keywords": ["人工智能"],
"maxItems": 10,
"proxyConfiguration": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("parsebird/wechat-official-accounts-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"keywords": [
"人工智能"
],
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": true
}
}' |
apify call parsebird/wechat-official-accounts-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/wechat-official-accounts-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/8b7auWKCxELfkhJb9/builds/mcib1MgrIVkrPdkh8/openapi.json