WeChat Official Accounts articles API
List the articles one Official Account has published by account. Each row has title, url, posted_at and position, and the field table also lists is_original and is_deleted. It costs $8 per 1,000 calls.
WeChat Official Account articles lists the articles one account has published, given account. Each row carries the title, link, cover image, publish time, position, whether it is marked original and whether it has been deleted. Use it to see what an account has been writing and how often it posts, for account evaluation, reviewing a competitor's content or building an industry article library.
account takes a WeChat ID, the raw ID starting with gh_, or an account or article link that identifies the account; a personal WeChat ID does not work. position is the article's slot in its push, the lowest being the lead article; is_deleted marks removed articles and is_original those that claim original authorship. account_ghid is the account's unique ID within WeChat, which makes it the right key for de-duplication.
is_deletedmarks articles that were deleted.- There is no date filter parameter.
- Failed calls and empty results are not charged.
May be temporarily unavailable at peak times
This capability may be temporarily unavailable at peak times; try again later. Failed calls are not charged.
API health
- 24h health
- 98%
- 24h average time
- 4.50 s
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "wechat_oa", "action": "account_articles", "params": { "account": "36氪" } }2JSON response
{ "results": [ { "title": "新天坑专业来了!", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/o02wSnKAPeGiaFn4ZHxq44OgF3EvsV427DibBQJ3Wm0d1Jp1al1aMxXGGT4DJibn5KRr8oiajiadOaNA1tK2Mic69MEHcZnAuwPKfyNCXM7zb2icT0/640?wxtype=jpeg&wxfrom=25", "posted_at": "2026-10-24T13:30:00+00:00", "position": 1 }, … ], "count": 36 }3Rows
title cover_image_url posted_at position 新天坑专业来了! https://mmbiz.qpic.cn/sz_mmbiz_jpg/o02wSnKAPeGiaFn4ZHxq44OgF3EvsV427DibBQJ3Wm0d1Jp1al1aMxXGGT4DJibn5KRr8oiajiadOaNA1tK2Mic69MEHcZnAuwPKfyNCXM7zb2icT0/640?wxtype=jpeg&wxfrom=25 2026-10-24T13:30:00+00:00 1 全脂中产疯抢「蛋白糕」:噎得干瞪眼也不能掉肌肉 https://mmbiz.qpic.cn/mmbiz_jpg/o02wSnKAPeGOU4Kj24AlXJ6tReJdcGBRu5HkBKicfQDxmkUPUgw1U2l3icNibSe0k2nbKqXmWmIe4ibatjOm0sxFahFotcDNia495enyZrOVbicVQ/300?wxtype=jpeg&wxfrom=25 2026-10-24T13:30:00+00:00 2 4CSV
wechat_oa-account_articles-sample.csv id,title,url,cover_image_url,posted_at,position,is_original,is_deleted,account_name,account_id,account_ghid,platform
account goes in, and a batch of that account's articles comes back; each row in results is one article, listed as a field table and a CSV file.What data you get
The table shows a real call for 36氪, captured October 24, 2026 at 18:28 (UTC), that returned 36 rows. Your own calls return these fields as listed in the field reference.
| id | title | url | cover_image_url | posted_at | position | is_original | is_deleted | account_name | account_id | account_ghid | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|
2248907014 | 新天坑专业来了! | http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=1&sn=53f65801e362eac1102cfd9ac0958ddd&chksm=e83826ef9b9138c6ac8c1e4b88daa14c0941bd82c199db5406890e2ccf5d02f76f320b805553&scene=126&sessionid=0#rd | https://mmbiz.qpic.cn/sz_mmbiz_jpg/o02wSnKAPeGiaFn4ZHxq44OgF3EvsV427DibBQJ3Wm0d1Jp1al1aMxXGGT4DJibn5KRr8oiajiadOaNA1tK2Mic69MEHcZnAuwPKfyNCXM7zb2icT0/640?wxtype=jpeg&wxfrom=25 | 2026-10-24T13:30:00+00:00 | 1 | null | null | null | null | gh_240fbf8b33e4 | wechat_oa |
2248907014 | 全脂中产疯抢「蛋白糕」:噎得干瞪眼也不能掉肌肉 | http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=2&sn=7742abe42aa2ecc2da11d0020e7d968f&chksm=e8a0eeb36a2ae07e805bb65471cd6c5726d303af90b895df7b9624215dacb7bb72ea8b1fb776&scene=126&sessionid=0#rd | https://mmbiz.qpic.cn/mmbiz_jpg/o02wSnKAPeGOU4Kj24AlXJ6tReJdcGBRu5HkBKicfQDxmkUPUgw1U2l3icNibSe0k2nbKqXmWmIe4ibatjOm0sxFahFotcDNia495enyZrOVbicVQ/300?wxtype=jpeg&wxfrom=25 | 2026-10-24T13:30:00+00:00 | 2 | null | null | null | null | gh_240fbf8b33e4 | wechat_oa |
Use cases
Build an article index for one account
Store
title,urlandposted_atfrom each row, and pass aurltoarticle_detailwhen you need the full text.Review a competitor account's topics
Lay out
titlebyposted_atto see what the account wrote lately and how often it posts.Read an account's lead article slots
positionis the article's slot within its push. A smaller number comes first, and the smallest is the lead article.Find articles that were deleted
is_deletedmarks articles whose content was deleted, so you can list them apart when you count posts.
WeChat Official Account interface for the list of published messages vs EveryInfra
Here is how the "get the list of published messages" interface in WeChat Open Documentation and EveryInfra account_articles compare on listing published articles and on the deleted flag.
| Compared | WeChat Official Account interface for the list of published messages | EveryInfra |
|---|---|---|
| Listing published articles | The page says the interface gets the list of messages that were published successfully, and the request address carries access_token. | account names the Official Account and limit sets how many rows come back. You need no access_token. |
| Deleted flag | is_deleted says whether the article was deleted. | is_deleted marks articles whose content was deleted. |
WeChat Open Documentation is in Chinese. The table shows a translation of the page for the list of published messages, checked on 2026-11-22; the update date of the page is in the sources. Official sources: Get the list of published messages (updated 2026-11-11)
Limits and gotchas
accountis required. It takes a WeChat ID, the original ID that starts with gh_, or an account or article link that identifies the account. A personal WeChat ID does not work.limitis capped at 160 rows per call. This capability has no paging parameter and no date filter, and it does not promise to cover every article the account ever posted.positionis the article's slot within its push. It is not a read count or a popularity rank.- Articles from one push may share the same
id. Tell articles apart byurl. account_ghidis the original ID of the account that starts with gh_, and it is unique within WeChat.
Pricing
You pay $0.008 per call, not per row. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $80.00 |
| 100,000 | $800.00 |
| 1,000,000 | $8,000.00 |
Totals use the list price per call.
Code samples
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "wechat_oa",
"action": "account_articles",
"params": {
"account": "36氪"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
API reference
See the parameters, response fields, errors and billing for account_articles, and copy the page or open it as Markdown for an AI assistant.
AI prompt
#Please help me write a data collection script with the EveryInfra WeChat Official Accounts Account articles endpoint (wechat_oa/account_articles).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to wechat_oa and action to account_articles, and put the parameters inside params.
- Required parameters:
- account: Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs.
- Optional parameters:
- limit: The most rows to return in this call, an integer from 1 to 160. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 8)
- Returns a list of records. Main fields of each record: id, title, url, cover_image_url (Cover image URL of the article), posted_at, position (Slot of the article within one push: th…), is_original (Whether the article carries an original…), is_deleted (Whether the content has been deleted), account_name (Name of the Official Account that publi…), account_id (Official Account ID (its WeChat ID)), account_ghid (The account's raw ID starting with gh_,…).
- Example request body:
{
"platform": "wechat_oa",
"action": "account_articles",
"params": {
"account": "36氪"
}
}
- Price: $8 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | wechat_oa | Platform identifier, fixed value. |
action | body | string | Yes | account_articles | Capability identifier, fixed value. |
account | body.params | string | Yes | - | Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs. Used by account_principal (for publisher profile metadata), account_articles (for historical post lists), and account_today_articles (for posts published today). |
limit | body.params | integer (1–160) | No | 8 | The most rows to return in this call, an integer from 1 to 160. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |
Response example
#{ "id": "req_…", "platform": "wechat_oa", "action": "account_articles", "results": [ { "id": 2248907014, "title": "新天坑专业来了!", "url": "http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=1&sn=53f65801e362eac1102cfd9ac0958ddd&chksm=e83826ef9b9138c6ac8c1e4b88daa14c0941bd82c199db5406890e2ccf5d02f76f320b805553&scene=126&sessionid=0#rd", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/o02wSnKAPeGiaFn4ZHxq44OgF3EvsV427DibBQJ3Wm0d1Jp1al1aMxXGGT4DJibn5KRr8oiajiadOaNA1tK2Mic69MEHcZnAuwPKfyNCXM7zb2icT0/640?wxtype=jpeg&wxfrom=25", "posted_at": "2026-10-24T13:30:00+00:00", "position": 1, "account_ghid": "gh_240fbf8b33e4", "platform": "wechat_oa" }, { "id": 2248907014, "title": "全脂中产疯抢「蛋白糕」:噎得干瞪眼也不能掉肌肉", "url": "http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=2&sn=7742abe42aa2ecc2da11d0020e7d968f&chksm=e8a0eeb36a2ae07e805bb65471cd6c5726d303af90b895df7b9624215dacb7bb72ea8b1fb776&scene=126&sessionid=0#rd", "cover_image_url": "https://mmbiz.qpic.cn/mmbiz_jpg/o02wSnKAPeGOU4Kj24AlXJ6tReJdcGBRu5HkBKicfQDxmkUPUgw1U2l3icNibSe0k2nbKqXmWmIe4ibatjOm0sxFahFotcDNia495enyZrOVbicVQ/300?wxtype=jpeg&wxfrom=25", "posted_at": "2026-10-24T13:30:00+00:00", "position": 2, "account_ghid": "gh_240fbf8b33e4", "platform": "wechat_oa" } ], "count": 36, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| Field | Meaning |
|---|---|
id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
title | Title. null when the platform has no titles (for example text-only posts). |
url | Link to the record on the platform. |
cover_image_url | Cover image URL of the article. |
posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
position | Slot of the article within one push: the lowest number is the lead article. It is not a ranking by reads or popularity. |
is_original | Whether the article carries an original-content declaration. |
is_deleted | Whether the content has been deleted. |
account_name | Name of the Official Account that published the article. |
account_id | Official Account ID (its WeChat ID). |
account_ghid | The account's raw ID starting with gh_, unique within WeChat. |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
FAQ
What can I pass as account?
A WeChat ID, the raw ID that starts with gh_, or an account or article link that identifies the account. Personal WeChat IDs do not work. If you only know the account's name, find its ID first with the WeChat Account search capability.
How do I spot original or deleted articles?
is_original is true when the article claims original authorship. is_deleted is true when the content has been removed; such links may no longer open, so count those articles separately.
How should I de-duplicate accounts?
Use account_ghid, the raw ID starting with gh_, which is unique within WeChat. Account names can change over time, so they make poor keys for the articles you store.
Which fields does Account articles return?
id, title, url, cover_image_url, posted_at, position, is_original, is_deleted, account_name, account_id and account_ghid.
Can I get only the articles from a certain period?
There is no date filter parameter. Read the rows and filter on posted_at yourself. For the articles of the current day only, use account_today_articles.
How much does one read of the article history cost?
It costs $0.008 per call, or $8 per 1,000 calls, billed per call and not per row. Failed calls and empty results are not charged.
Related WeChat Official Accounts endpoints
You can call the other WeChat Official Accounts endpoints with the same EveryInfra API key.
- Article search
article_search$8 per 1,000 callsSearch WeChat Official Account articles by keyword through an English-documented API, up to 400 articles per call. - Article details
article_detail$5.56 per 1,000 callsFetch the full body of one WeChat Official Account article as plain text and original HTML. - Account search
account_search$16 per 1,000 callsLook up WeChat Official Accounts by keyword, up to 400 per call. - Mini Program search
mini_program_search$5.56 per 1,000 callsDiscover WeChat Mini Programs for a keyword, with name, icon, description, username and whether each one is a mini game. - Search suggestions
search_suggestions$5.56 per 1,000 callsGet the autocomplete suggestions WeChat offers for a keyword, along with the number of terms returned. - Account details
account_profile$8 per 1,000 callsGet a WeChat Official Account profile as JSON. - Account owner
account_principal$5.56 per 1,000 callsRead the registered owner behind a WeChat Official Account. - Today's account articles
account_today_articles$8 per 1,000 callsTrack what one WeChat Official Account has published today, with each article's title, link, cover, publish time, position and original or deleted flags. - Article comments
article_comments$6.76 per 1,000 callsCollect reader comments on one WeChat Official Account article, up to 260 per call. - Comment replies
comment_replies$6.76 per 1,000 callsList the replies under one comment on a WeChat Official Account article. - Article engagement
article_metrics$5.56 per 1,000 callsCheck engagement on one WeChat Official Account article. - WeChat Index
wechat_index$5.56 per 1,000 callsGauge how much attention a keyword gets on WeChat: the latest index value and its date, plus the trend series behind it.