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
Healthy

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "wechat_oa",
      "action": "article_search",
      "params": {
        "keyword": "城市更新"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "title": "城市更新的八大类型及典型案例分析(含城市更新专题)",
          "summary": "城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...",
          "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg"
        },
        …
      ],
      "count": 18
    }
  3. 3Rows

    titlesummarycover_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
  4. 4CSV

    wechat_oa-article_search-sample.csv id,title,summary,url,cover_image_url,account_name,posted_at,relative_time,kind,platform

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

idtitlesummaryurlcover_image_urlaccount_nameposted_atrelative_timekindplatform
null城市更新的八大类型及典型案例分析(含城市更新专题)城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...https://mp.weixin.qq.com/s?src=11&timestamp=1792868283&ver=7046&signature=*kBvA0oukPYHXfmpZWB8cGEugO6pKS0z0G92kHumYr3SO2wiEAGXPgRFIhHBwGjs86NVY6sKC3E-0*IaVBC8XRM3Qb3zBoeF2nH4x6l0S8JKbSmgSBy6PlE2GXzT9uOi&new=1https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpegnullnullnullnullwechat_oa
null李迎伟主持研究城市更新工作李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟...https://mp.weixin.qq.com/s?src=11&timestamp=1792868283&ver=7046&signature=gzDMFycW6XM4lIXPZ4-qV6LZtQ9JRqDobvYNMGB*W72r5GzoRJTTcH4Y6VZ80RU45fRbEl*bLgZQ548peOPI59SvamTDpdthJzT4BoTP2ueI5lt1ZdS788YtogIxWaYc&new=1https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpegnullnullnullnullwechat_oa

Use cases

  • See how a topic is covered

    Search an industry term and read the title and summary of each row to see which angles the accounts take.

  • Watch a brand term for new articles

    Set category to LATEST and 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_name in the results, then pass the name to account_search to get the account identifier.

Limits and gotchas

  • keyword is required and searches Official Account articles. To search accounts, use account_search. It is not a search of personal WeChat chats.
  • category takes ALL, LATEST, HOT, FOLLOWED or RECENT_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_type is an older name for category with the same values; it is converted to upper case. When both are sent, category wins.
  • limit is capped at 400 rows per call; this capability has no paging parameter.
  • relative_time is a relative phrase such as "3 days ago". To sort by time, use posted_at.

Pricing

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

CallsCost
10,000$80.00
100,000$800.00
1,000,000$8,000.00

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

POST

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

#
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_searchCapability identifier, fixed value.
keywordbody.paramsstringYes-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.
categorybody.paramsstringNo-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_typebody.paramsstringNo-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.
limitbody.paramsinteger (1–400)No20The 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

#
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_search",  "results": [    {      "title": "城市更新的八大类型及典型案例分析(含城市更新专题)",      "summary": "城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...",      "url": "https://mp.weixin.qq.com/s?src=11&timestamp=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&timestamp=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.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
titleTitle. null when the platform has no titles (for example text-only posts).
summaryArticle summary shown in the search result.
urlLink to the record on the platform.
cover_image_urlCover image URL of the article.
account_nameName of the Official Account that published the article.
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.
relative_timeRelative time as WeChat displays it (such as 3 days ago); sort by posted_at instead.
kindResult type as WeChat labels it.
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 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.

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

Google Analytics needs consent. Privacy