WeChat Official Accounts Article search API
Search Official Account articles by keyword, pick a section with category, and get title, summary, url and cover_image_url for each row. The field table also lists account_name and posted_at. It costs $8 per 1,000 calls.
WeChat Official Account article search finds articles from public WeChat accounts by keyword and returns each article's title, summary, link, cover image, account name and publish time. Use it to see which articles cover a topic and who writes them: industry news monitoring, collecting public opinion, finding accounts to partner with, or building a topic library.
Pick a section with category: ALL, LATEST or HOT. FOLLOWED and RECENT_READ depend on a personal sign-in, and no WeChat sign-in is passed here, so they are not guaranteed to work and never read your own follows or reading history. posted_at is a standard timestamp while relative_time is a relative phrase as WeChat displays it, so sort by the former. Open url to read the full article.
- Pick the all, latest or hot section with
category. - It searches Official Account articles, not personal WeChat chats.
- 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
- 96%
- 24h average time
- 11.51 s
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "wechat_oa", "action": "article_search", "params": { "keyword": "城市更新" } }2JSON response
{ "results": [ { "title": "城市更新的八大类型及典型案例分析(含城市更新专题)", "summary": "城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg" }, … ], "count": 18 }3Rows
title summary cover_image_url 城市更新的八大类型及典型案例分析(含城市更新专题) 城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更... https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg 李迎伟主持研究城市更新工作 李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟... https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpeg 4CSV
wechat_oa-article_search-sample.csv id,title,summary,url,cover_image_url,account_name,posted_at,relative_time,kind,platform
keyword goes in, and a batch of article leads comes back; each row in results is one article, listed as a field table and a CSV file.What data you get
The table shows a real call for 城市更新, captured October 24, 2026 at 18:28 (UTC), that returned 18 rows. Your own calls return these fields as listed in the field reference.
| id | title | summary | url | cover_image_url | account_name | posted_at | relative_time | kind | platform |
|---|---|---|---|---|---|---|---|---|---|
null | 城市更新的八大类型及典型案例分析(含城市更新专题) | 城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更... | https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=*kBvA0oukPYHXfmpZWB8cGEugO6pKS0z0G92kHumYr3SO2wiEAGXPgRFIhHBwGjs86NVY6sKC3E-0*IaVBC8XRM3Qb3zBoeF2nH4x6l0S8JKbSmgSBy6PlE2GXzT9uOi&new=1 | https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg | null | null | null | null | wechat_oa |
null | 李迎伟主持研究城市更新工作 | 李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟... | https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=gzDMFycW6XM4lIXPZ4-qV6LZtQ9JRqDobvYNMGB*W72r5GzoRJTTcH4Y6VZ80RU45fRbEl*bLgZQ548peOPI59SvamTDpdthJzT4BoTP2ueI5lt1ZdS788YtogIxWaYc&new=1 | https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpeg | null | null | null | null | wechat_oa |
Use cases
See how a topic is covered
Search an industry term and read the
titleandsummaryof each row to see which angles the accounts take.Watch a brand term for new articles
Set
categorytoLATESTand search the brand or a competitor's name on a schedule to see what was posted.Find accounts that write about a topic
Read
account_namein the results, then pass the name toaccount_searchto get the account identifier.
Limits and gotchas
keywordis required and searches Official Account articles. To search accounts, useaccount_search. It is not a search of personal WeChat chats.categorytakesALL,LATEST,HOT,FOLLOWEDorRECENT_READ. The last two depend on a WeChat sign-in. Your sign-in is not used here, so results are not guaranteed, and your own follows and reading history are never read.sub_typeis an older name forcategorywith the same values; it is converted to upper case. When both are sent,categorywins.limitis capped at 400 rows per call; this capability has no paging parameter.relative_timeis a relative phrase such as "3 days ago". To sort by time, useposted_at.
Pricing
You pay $0.008 per call, not per row. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $80.00 |
| 100,000 | $800.00 |
| 1,000,000 | $8,000.00 |
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_search",
"params": {
"keyword": "城市更新"
}
}'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_search, 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 search endpoint (wechat_oa/article_search).
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_search, and put the parameters inside params.
- Required parameters:
- keyword: Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions…
- Optional parameters:
- category: Filters articles by category in the article_search action. Allowed values are ALL, LATEST, HOT, FOLLOWED, and RECENT_READ. Note that FOLLOWED and RECENT_READ depend on account state.
- sub_type: A compatibility alias for category in article_search that accepts the same five category values (automatically converted to uppercase). If both category and sub_type are provided, category takes precedence.
- limit: The most rows to return in this call, an integer from 1 to 400. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 20)
- Returns a list of records. Main fields of each record: id, title, summary (Article summary shown in the search res…), url, cover_image_url (Cover image URL of the article), account_name (Name of the Official Account that publi…), posted_at, relative_time (Relative time as WeChat displays it (su…), kind (Result type as WeChat labels it).
- Example request body:
{
"platform": "wechat_oa",
"action": "article_search",
"params": {
"keyword": "城市更新"
}
}
- Price: $8 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_search | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | Specifies the search term across WeChat Official Account actions, including searching articles (article_search), accounts (account_search), mini programs (mini_program_search), search auto-suggestions (search_suggestions), and trend indices (wechat_index). It does not search personal WeChat chats. |
category | body.params | string | No | - | Filters articles by category in the article_search action. Allowed values are ALL, LATEST, HOT, FOLLOWED, and RECENT_READ. Note that FOLLOWED and RECENT_READ depend on account state; because your personal WeChat login session is not passed, these options are not guaranteed to work and will not read your personal subscription or reading history. |
sub_type | body.params | string | No | - | A compatibility alias for category in article_search that accepts the same five category values (automatically converted to uppercase). If both category and sub_type are provided, category takes precedence. |
limit | body.params | integer (1–400) | No | 20 | The most rows to return in this call, an integer from 1 to 400. 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_search", "results": [ { "title": "城市更新的八大类型及典型案例分析(含城市更新专题)", "summary": "城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...", "url": "https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=*kBvA0oukPYHXfmpZWB8cGEugO6pKS0z0G92kHumYr3SO2wiEAGXPgRFIhHBwGjs86NVY6sKC3E-0*IaVBC8XRM3Qb3zBoeF2nH4x6l0S8JKbSmgSBy6PlE2GXzT9uOi&new=1", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg", "platform": "wechat_oa" }, { "title": "李迎伟主持研究城市更新工作", "summary": "李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟...", "url": "https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=gzDMFycW6XM4lIXPZ4-qV6LZtQ9JRqDobvYNMGB*W72r5GzoRJTTcH4Y6VZ80RU45fRbEl*bLgZQ548peOPI59SvamTDpdthJzT4BoTP2ueI5lt1ZdS788YtogIxWaYc&new=1", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpeg", "platform": "wechat_oa" } ], "count": 18, "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. |
title | Title. null when the platform has no titles (for example text-only posts). |
summary | Article summary shown in the search result. |
url | Link to the record on the platform. |
cover_image_url | Cover image URL of the article. |
account_name | Name of the Official Account that published the article. |
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. |
relative_time | Relative time as WeChat displays it (such as 3 days ago); sort by posted_at instead. |
kind | Result type as WeChat labels it. |
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 category should I use?
ALL, LATEST and HOT cover most needs. FOLLOWED and RECENT_READ depend on a personal WeChat sign-in, which is not passed here, so they are not guaranteed to work. sub_type is an older name for the same setting; when both are sent, category wins.
Is this the same as searching inside WeChat?
It searches Official Account articles, not personal chats or Moments, and it never reads your own follows or reading history. Result order depends on the section you pick and may differ from what you see when you search on your own phone.
Can I pass a result's url to the comment or metrics capabilities?
Not always. Search results mostly carry temporary links with signature and timestamp parameters, and the article comment, reply and metrics capabilities answer 422 before any charge when they cannot read one. Open the article in a browser, copy its own link, a /s/ short link or one with __biz, mid, idx and sn, and pass that instead.
What does article search return?
Each row is one article: title, summary, url and cover_image_url. The field table also lists id, account_name, posted_at, relative_time and kind.
How do I find the account behind an article?
account_name is the account's name. Pass that name as keyword to account_search, then use ghid from the result as account to read the single account.
How much does one search cost?
It costs $0.008 per call, or $8 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 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. - 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.