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 id becomes comment_id when you read the replies.
  • reply_count is only a count; read the replies with comment_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
Normal

Last 24 hours

Last 30 days

  1. 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"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "author_name": "",
          "text": "我曾经因为不刮腋毛被朋友说“恶心”。。。。。\n不知道哪里来的这种审美捆绑。。。。。。\n谢谢丁香为我正名!!!!!",
          "like_count": 1056,
          "posted_at": "2026-07-31T03:59:18+00:00"
        },
        …
      ],
      "count": 20
    }
  3. 3Rows

    author_nametextlike_countposted_at
    我曾经因为不刮腋毛被朋友说“恶心”。。。。。 不知道哪里来的这种审美捆绑。。。。。。 谢谢丁香为我正名!!!!!10562026-07-31T03:59:18+00:00
    有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期2352026-07-31T03:59:05+00:00
  4. 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

A request with the article 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.

idtextauthor_nameauthor_avatar_urllike_countposted_atis_topreply_countcountryprovinceplatform
我曾经因为不刮腋毛被朋友说“恶心”。。。。。 不知道哪里来的这种审美捆绑。。。。。。 谢谢丁香为我正名!!!!!10562026-07-31T03:59:18+00:0004中国广东wechat_oa
有没有什么止汗露什么的测评来一期! 爱出汗星人强烈求一期2352026-07-31T03:59:05+00:0001中国湖南wechat_oa

Use cases

  • Sample reader feedback

    Read a batch of text values to see what readers say about the article.

  • Find the comments readers back

    Sort by like_count from high to low. The first rows are the comments with the most likes.

  • Read pinned comments on their own

    is_top marks pinned comments, so you can read them apart from the others.

  • Pick out comments that drew replies

    For a comment whose reply_count is above 0, pass its id and the same url to comment_replies to 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.

ComparedWeChat Official Account interface for article commentsEveryInfra
Which article you readThe 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 callIn 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

  • url is required. Use the article's own link on mp.weixin.qq.com: the /s/<id> short link, or a link with __biz, mid, idx and sn.
  • A temporary link from search results (with signature and timestamp) may not be readable. When it cannot be read, the call returns 422 before any charge.
  • limit is capped at 260 rows per call; this capability has no paging parameter.
  • reply_count is how many replies a comment has. It is only a number; read the replies themselves with comment_replies.
  • is_top is the pinned mark. country and province are 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.

CallsCost
10,000$67.64
100,000$676.39
1,000,000$6,763.89

Totals use the list price per call.

Code samples

#
bash
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.

POST

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

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYeswechat_oaPlatform identifier, fixed value.
actionbodystringYesarticle_commentsCapability identifier, fixed value.
urlbody.paramsstringYes-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.
limitbody.paramsinteger (1–260)No13The 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

#
Captured October 24, 2026 at 18:28 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
textBody 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_nameAuthor's display name.
author_avatar_urlKeeps the platform's own meaning
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
posted_atPublish 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_topKeeps the platform's own meaning
reply_countReplies, usually replies to a comment. null means not disclosed.
countryCountry or region: a full name or an ISO code depending on the platform, not normalized.
provinceKeeps the platform's own meaning
platformSource 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.

Errors

Official references

#

Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.

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.

You can call the other WeChat Official Accounts endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy