WeChat Official Accounts Article engagement API

Read the interaction counts of one Official Account article from its link url: read_count, like_count, watching_count, share_count, collect_count and comment_count, for $5.56 per 1,000 calls.

  • watching_count is the Looking count, kept apart from likes.
  • One call returns one object, not a list.
  • 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_metrics",
      "params": {
        "url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0"
      }
    }
  2. 2JSON response

    {
      "results": {
        "read_count": 100001,
        "like_count": 1043,
        "watching_count": 122,
        "share_count": 3466,
        …
      }
    }
  3. 3Fields

    read_countlike_countwatching_countshare_count
    10000110431223466
  4. 4CSV

    wechat_oa-article_metrics-sample.csv read_count,like_count,watching_count,share_count,collect_count,comment_count,platform

A request with the article url goes in, and one JSON object comes back; read_count and like_count are among its fields, 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 one object. Your own calls return these fields as listed in the field reference.

read_countlike_countwatching_countshare_countcollect_countcomment_countplatform
1000011043122346635840wechat_oa

Use cases

  • Keep an interaction snapshot of an article

    Read the six counts of the same article on a schedule and store each value with its capture time.

  • Keep likes and Looking apart

    like_count is likes and watching_count is the Looking count. Store the two metrics apart and do not add them.

  • Decide whether the comments are worth reading

    Check comment_count first, and when there are comments, pass the same url to article_comments.

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.
  • watching_count is the Looking count, an interaction metric specific to Official Accounts and different from likes.
  • The result holds this one set of counts. It has no data split by date. Do not fill a missing count with 0.
  • comment_count is a count of comments. To read the comments, use article_comments.

Pricing

You pay $0.005556 per call, not per row. Failed calls and empty results are not charged.

CallsCost
10,000$55.56
100,000$555.56
1,000,000$5,555.56

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_metrics",
  "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_metrics, 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 engagement endpoint (wechat_oa/article_metrics).

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_metrics, 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).
- Returns one object. Main fields: read_count, like_count, watching_count, share_count, collect_count, comment_count.
- Example request body:
{
  "platform": "wechat_oa",
  "action": "article_metrics",
  "params": {
    "url": "https://mp.weixin.qq.com/s?__biz=MzA4MTg0MjA5OQ==&mid=2655362972&idx=1&sn=b56fabd8e4c53259498100f05f20dbb0"
  }
}
- Price: $5.56 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_metricsCapability 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.

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. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "wechat_oa",  "action": "article_metrics",  "results": {    "read_count": 100001,    "like_count": 1043,    "watching_count": 122,    "share_count": 3466,    "collect_count": 358,    "comment_count": 40,    "platform": "wechat_oa"  },  "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
read_countKeeps the platform's own meaning
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
watching_countKeeps the platform's own meaning
share_countShares. null means not disclosed, not 0.
collect_countSaves or favorites. null means not disclosed, not 0.
comment_countComments. null means not disclosed, not 0.
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

FAQ

Which fields does Article metrics return?

read_count, like_count, watching_count, share_count, collect_count and comment_count.

Are Looking and likes the same thing?

No. watching_count is the Looking count, which is specific to Official Accounts and is not the same as the likes in like_count.

How much does the interaction data of one article cost?

It costs $0.005556 per call, or $5.56 per 1,000 calls, and one call reads one article. 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