# WeChat Official Accounts Account articles API (wechat_oa.account_articles)

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

WeChat Official Account articles lists the articles one account has published, given `account`. Each row carries the title, link, cover image, publish time, position, whether it is marked original and whether it has been deleted. Use it to see what an account has been writing and how often it posts, for account evaluation, reviewing a competitor's content or building an industry article library.

`account` takes a WeChat ID, the raw ID starting with gh_, or an account or article link that identifies the account; a personal WeChat ID does not work. `position` is the article's slot in its push, the lowest being the lead article; `is_deleted` marks removed articles and `is_original` those that claim original authorship. `account_ghid` is the account's unique ID within WeChat, which makes it the right key for de-duplication.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| account | not declared | yes | not declared | Identifies the target WeChat Official Account using its WeChat ID, raw ID (starting with gh_), or a resolvable account/article URL. It does not accept personal WeChat IDs. Used by account_principal (for publisher profile metadata), account_articles (for historical post lists), and account_today_articles (for posts published today). |
| limit | integer (1–160) | no | 8 | The most rows to return in this call, an integer from 1 to 160. 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). |
| url | Link to the record on the platform. |
| cover_image_url | Cover image URL of 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. |
| position | Slot of the article within one push: the lowest number is the lead article. It is not a ranking by reads or popularity. |
| is_original | Whether the article carries an original-content declaration. |
| is_deleted | Whether the content has been deleted. |
| account_name | Name of the Official Account that published the article. |
| account_id | Official Account ID (its WeChat ID). |
| account_ghid | The account's raw ID starting with gh_, unique within WeChat. |
| 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": "account_articles",
  "params": {
    "account": "36氪"
  }
}'
```

```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": "account_articles",
        "params": {
            "account": "36氪",
        },
    },
    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 36. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "wechat_oa",
  "action": "account_articles",
  "results": [
    {
      "id": 2248907014,
      "title": "新天坑专业来了！",
      "url": "http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=1&sn=53f65801e362eac1102cfd9ac0958ddd&chksm=e83826ef9b9138c6ac8c1e4b88daa14c0941bd82c199db5406890e2ccf5d02f76f320b805553&scene=126&sessionid=0#rd",
      "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/o02wSnKAPeGiaFn4ZHxq44OgF3EvsV427DibBQJ3Wm0d1Jp1al1aMxXGGT4DJibn5KRr8oiajiadOaNA1tK2Mic69MEHcZnAuwPKfyNCXM7zb2icT0/640?wxtype=jpeg&wxfrom=25",
      "posted_at": "2026-10-24T13:30:00+00:00",
      "position": 1,
      "account_ghid": "gh_240fbf8b33e4",
      "platform": "wechat_oa"
    },
    {
      "id": 2248907014,
      "title": "全脂中产疯抢「蛋白糕」：噎得干瞪眼也不能掉肌肉",
      "url": "http://mp.weixin.qq.com/s?__biz=MzI2NDk5NzA0Mw==&mid=2248907014&idx=2&sn=7742abe42aa2ecc2da11d0020e7d968f&chksm=e8a0eeb36a2ae07e805bb65471cd6c5726d303af90b895df7b9624215dacb7bb72ea8b1fb776&scene=126&sessionid=0#rd",
      "cover_image_url": "https://mmbiz.qpic.cn/mmbiz_jpg/o02wSnKAPeGOU4Kj24AlXJ6tReJdcGBRu5HkBKicfQDxmkUPUgw1U2l3icNibSe0k2nbKqXmWmIe4ibatjOm0sxFahFotcDNia495enyZrOVbicVQ/300?wxtype=jpeg&wxfrom=25",
      "posted_at": "2026-10-24T13:30:00+00:00",
      "position": 2,
      "account_ghid": "gh_240fbf8b33e4",
      "platform": "wechat_oa"
    }
  ],
  "count": 36,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What can I pass as `account`?

A WeChat ID, the raw ID that starts with gh_, or an account or article link that identifies the account. Personal WeChat IDs do not work. If you only know the account's name, find its ID first with the WeChat Account search capability.

### How do I spot original or deleted articles?

`is_original` is true when the article claims original authorship. `is_deleted` is true when the content has been removed; such links may no longer open, so count those articles separately.

### How should I de-duplicate accounts?

Use `account_ghid`, the raw ID starting with gh_, which is unique within WeChat. Account names can change over time, so they make poor keys for the articles you store.

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