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_countis 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
Last 24 hours
Last 30 days
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" } }2JSON response
{ "results": { "read_count": 100001, "like_count": 1043, "watching_count": 122, "share_count": 3466, … } }3Fields
read_count like_count watching_count share_count 100001 1043 122 3466 4CSV
wechat_oa-article_metrics-sample.csv read_count,like_count,watching_count,share_count,collect_count,comment_count,platform
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_count | like_count | watching_count | share_count | collect_count | comment_count | platform |
|---|---|---|---|---|---|---|
100001 | 1043 | 122 | 3466 | 358 | 40 | wechat_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_countis likes andwatching_countis the Looking count. Store the two metrics apart and do not add them.Decide whether the comments are worth reading
Check
comment_countfirst, and when there are comments, pass the sameurltoarticle_comments.
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. watching_countis 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_countis a count of comments. To read the comments, usearticle_comments.
Pricing
You pay $0.005556 per call, not per row. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $55.56 |
| 100,000 | $555.56 |
| 1,000,000 | $5,555.56 |
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_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.
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
#| 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_metrics | 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. |
Response example
#{ "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.
| Field | Meaning |
|---|---|
read_count | Keeps the platform's own meaning |
like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
watching_count | Keeps the platform's own meaning |
share_count | Shares. null means not disclosed, not 0. |
collect_count | Saves or favorites. null means not disclosed, not 0. |
comment_count | Comments. null means not disclosed, not 0. |
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
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.
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. - 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. - 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.