WeChat Official Accounts Article comments API
Read the comments under one Official Account article from its link url: text, like_count, posted_at, is_top, reply_count, and the commenter's country and province, for $6.76 per 1,000 calls.
WeChat Official Account Article comments returns the public comments on one article from its url: for each comment, the text in full, who wrote it and their avatar, the likes, when it was posted, whether it is pinned, how many replies it drew, and the country and province shown with it. PR and communications teams use it to see how readers took a press release or a statement, and content teams use it to learn which points readers pick up, question or dispute.
Pass the article's own link on mp.weixin.qq.com, not an account page. is_top marks comments pinned to the top, which readers see first, so keep them apart when you score sentiment. Sorting by like_count shows which reactions other readers endorsed, and replies sit one level down, where the WeChat Comment replies capability reads them.
- The comment
idbecomescomment_idwhen you read the replies. reply_countis only a count; read the replies withcomment_replies.- 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
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "wechat_oa", "action": "article_comments", "params": { "url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0" } }2JSON response
{ "results": [ { "author_name": "", "text": "我曾经因为不刮腋毛被朋友说“恶心”。。。。。\n不知道哪里来的这种审美捆绑。。。。。。\n谢谢丁香为我正名!!!!!", "like_count": 1056, "posted_at": "2026-07-31T03:59:18+00:00" }, … ], "count": 20 }3Rows
author_name text like_count posted_at 我曾经因为不刮腋毛被朋友说“恶心”。。。。。 不知道哪里来的这种审美捆绑。。。。。。 谢谢丁香为我正名!!!!! 1056 2026-07-31T03:59:18+00:00 有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期 235 2026-07-31T03:59:05+00:00 4CSV
wechat_oa-article_comments-sample.csv id,text,author_name,author_avatar_url,like_count,posted_at,is_top,reply_count,country,province,platform
url goes in, and a batch of comments on that article comes back; each row in results is one comment, listed as a field table and a CSV file.What data you get
The table shows a real call for mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0, captured October 24, 2026 at 18:28 (UTC), that returned 20 rows; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.
| id | text | author_name | author_avatar_url | like_count | posted_at | is_top | reply_count | country | province | platform |
|---|---|---|---|---|---|---|---|---|---|---|
| 我曾经因为不刮腋毛被朋友说“恶心”。。。。。 不知道哪里来的这种审美捆绑。。。。。。 谢谢丁香为我正名!!!!! | 1056 | 2026-07-31T03:59:18+00:00 | 0 | 4 | 中国 | 广东 | wechat_oa | |||
| 有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期 | 235 | 2026-07-31T03:59:05+00:00 | 0 | 1 | 中国 | 湖南 | wechat_oa |
Use cases
Sample reader feedback
Read a batch of
textvalues to see what readers say about the article.Find the comments readers back
Sort by
like_countfrom high to low. The first rows are the comments with the most likes.Read pinned comments on their own
is_topmarks pinned comments, so you can read them apart from the others.Pick out comments that drew replies
For a comment whose
reply_countis above 0, pass itsidand the sameurltocomment_repliesto read on.
WeChat Official Account interface for article comments vs EveryInfra
Here is how the "list the comments on an article" interface in WeChat Open Documentation and EveryInfra article_comments compare on which article you read and who can call.
| Compared | WeChat Official Account interface for article comments | EveryInfra |
|---|---|---|
| Which article you read | The request address carries access_token. The request body parameter msg_data_id is the msg_data_id returned by the mass send, and index picks which article of a multi-article message, counting from 0. | url takes the article's own link on mp.weixin.qq.com. You need no msg_data_id. |
| Who can call | In the scope table, both the Official Account and the service account are marked as verified accounts only. Error code 88000 reads "without comment privilege". | You do not have to operate the article's account to read its comments. |
WeChat Open Documentation is in Chinese. The table shows a translation of the page for article comments, checked on 2026-11-22; the update date of the page is in the sources. Official sources: List the comments on an article (updated 2025-07-09)
Limits and gotchas
urlis required. Use the article's own link on mp.weixin.qq.com: the/s/<id>short link, or a link with__biz,mid,idxandsn.- A temporary link from search results (with
signatureandtimestamp) may not be readable. When it cannot be read, the call returns 422 before any charge. limitis capped at 260 rows per call; this capability has no paging parameter.reply_countis how many replies a comment has. It is only a number; read the replies themselves withcomment_replies.is_topis the pinned mark.countryandprovinceare the country and province shown for the commenter.
Pricing
You pay $0.006764 per call, not per row. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $67.64 |
| 100,000 | $676.39 |
| 1,000,000 | $6,763.89 |
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": "article_comments",
"params": {
"url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0"
}
}'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 article_comments, 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 Article comments endpoint (wechat_oa/article_comments).
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 article_comments, and put the parameters inside params.
- Required parameters:
- url: Specifies the article's own mp.weixin.qq.com link for article_comments, comment_replies, article_metrics, and article_detail: open the article and copy it (a /s/<id> short link, or a link with __biz, mid, idx, and sn).
- Optional parameters:
- limit: The most rows to return in this call, an integer from 1 to 260. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 13)
- Returns a list of records. Main fields of each record: id, text, author_name, author_avatar_url, like_count, posted_at, is_top, reply_count, country, province.
- Example request body:
{
"platform": "wechat_oa",
"action": "article_comments",
"params": {
"url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0"
}
}
- Price: $6.76 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 | article_comments | Capability identifier, fixed value. |
url | body.params | string | Yes | - | Specifies the article's own mp.weixin.qq.com link for article_comments, comment_replies, article_metrics, and article_detail: open the article and copy it (a /s/<id> short link, or a link with __biz, mid, idx, and sn). Temporary links copied from search results (with signature/timestamp) may not be readable; when they cannot be read, the call returns 422 before any charge. Account-level actions accept this parameter only as a lowest-priority fallback input for resolving the target account. |
limit | body.params | integer (1–260) | No | 13 | The most rows to return in this call, an integer from 1 to 260. 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": "article_comments", "results": [ { "id": "•••", "text": "我曾经因为不刮腋毛被朋友说“恶心”。。。。。\n不知道哪里来的这种审美捆绑。。。。。。\n谢谢丁香为我正名!!!!!", "author_name": "•••", "author_avatar_url": "https://wx.qlogo.cn/•••", "like_count": 1056, "posted_at": "2026-07-31T03:59:18+00:00", "is_top": 0, "reply_count": 4, "country": "中国", "province": "广东", "platform": "wechat_oa" }, { "id": "•••", "text": "有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期", "author_name": "•••", "author_avatar_url": "https://wx.qlogo.cn/•••", "like_count": 235, "posted_at": "2026-07-31T03:59:05+00:00", "is_top": 0, "reply_count": 1, "country": "中国", "province": "湖南", "platform": "wechat_oa" } ], "count": 20, "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. |
text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
author_name | Author's display name. |
author_avatar_url | Keeps the platform's own meaning |
like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
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. |
is_top | Keeps the platform's own meaning |
reply_count | Replies, usually replies to a comment. null means not disclosed. |
country | Country or region: a full name or an ISO code depending on the platform, not normalized. |
province | Keeps the platform's own meaning |
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.
Official references
#Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.
- WeChat Official Accounts: Distinction Between Article Comments and Featured Comments ↗
WeChat comment documentation distinguishes among articles, comment IDs, featured flags, and reply details. The comment scope visible in the backend of official authorized interfaces is not identical to the visibility scope of this endpoint, and `is_top` cannot be directly treated as the official comment_type featured flag.
Checked 2026-09-04
FAQ
Which link does url need?
The article's own address on mp.weixin.qq.com, such as the long form with __biz, mid, idx and sn in the query string that the example on this page uses. An account profile link or a search page does not point at a single article, so it cannot return that article's comments.
How do I get the replies to a comment?
Check reply_count. When it is above zero, pass the same article url and that row's id to the WeChat Comment replies capability, which takes them as the article link and the comment ID. Both must come from the same article, since a comment ID only means something together with its own article link.
What do country and province describe?
The location shown with each comment. country comes back as a full name or an ISO code depending on the source, without normalization, so map both forms to one list before you count comments by country. province gives the region within the country when it is shown.
Which fields does Article comments return?
id, text, author_name, author_avatar_url, like_count, posted_at, is_top, reply_count, country and province.
How much does reading the comments of one article cost?
It costs $0.006764 per call, or $6.76 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. - Account articles
account_articles$8 per 1,000 callsPull the article history of one WeChat Official Account, 8 by default and up to 160 per call. - 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. - 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.