# WeChat Official Accounts Article comments API (wechat_oa.article_comments)

- Canonical page: [https://everyinfra.com/en/wechat-oa-api/article_comments](https://everyinfra.com/en/wechat-oa-api/article_comments?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "wechat_oa", "action": "article_comments", "params": {...}}
- Price: $0.006764 per call ($6.76 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 13, max 260 per call
- Mode: sync; add "mode": "async" for slow tasks

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.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=wechat_oa&action=article_comments

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | 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 | 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 fields (items in `results`)

| 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 | platform-native 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 | platform-native 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 | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```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"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "wechat_oa",
        "action": "article_comments",
        "params": {
            "url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "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": { … }
}
```

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

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_oa
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
