# WeChat Official Accounts Article search API (wechat_oa.article_search)

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

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.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 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 | not declared | no | not declared | 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 | not declared | no | not declared | 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 | 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 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. |
| 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). |

## 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_search",
  "params": {
    "keyword": "城市更新"
  }
}'
```

```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_search",
        "params": {
            "keyword": "城市更新",
        },
    },
    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 18. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

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

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

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