<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 微信文章转存

> 输入微信公众号文章链接，抓取并转为Markdown/纯文本，提取标题、作者、公众号名称、发布时间，下载正文图片资源。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `wechat-archive` |
| 接口名称 | 微信文章转存 |
| 接口地址 | `https://v1.apizero.cn/api/wechat-archive` |
| 请求方法 | `POST` |
| 分类 | content |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 1 req/s |
| 每日免费额度 | 10 次（已认证用户） |
| 匿名每日额度 | 0 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要 API Key。登录用户每日 10 次免费。不开放匿名访问。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `url` | `string` | 是 | 微信公众号文章链接 | `https://mp.weixin.qq.com/s/hy31xZK6FH3H51qh1zeSKA` |
| `format` | `string` | 否 | 输出格式：markdown/text/both | `both` |
| `timeout` | `int` | 否 | 超时秒数 | `20` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 是 | — | — |

## 5. 请求示例 (cURL)

```bash
curl -X POST "https://v1.apizero.cn/api/wechat-archive" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://mp.weixin.qq.com/s/hy31xZK6FH3H51qh1zeSKA",
  "format": "both",
  "timeout": "20"
}'
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `meta.title` | `string` | 文章标题 | — |
| `meta.author` | `string` | 作者 | — |
| `meta.account_name` | `string` | 公众号名称 | — |
| `meta.publish_time` | `string` | 发布时间 | — |
| `meta.read_num` | `int\|null` | 阅读量（可能为null） | — |
| `meta.like_num` | `int\|null` | 点赞/在看数（可能为null） | — |
| `content.markdown` | `string` | Markdown正文 | — |
| `content.text` | `string` | 纯文本正文 | — |
| `images` | `array` | 图片数组（url/size_bytes） | — |

## 7. 响应示例

```json
{
    "code": 0,
    "msg": "成功",
    "data": {
        "meta": {
            "title": "GitHub史上最快破10万星项目来了",
            "author": "作者名",
            "account_name": "公众号名",
            "publish_time": "2026-05-01T10:00:00+08:00",
            "read_num": null,
            "like_num": null
        },
        "content": {
            "markdown": "# 文章标题\\n\\n正文...",
            "text": "文章标题\\n\\n正文..."
        },
        "images": [
            {
                "url": "https:\/\/mmbiz.qpic.cn\/...",
                "size_bytes": 45000
            }
        ]
    },
    "request_id": "req_abc123"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `—` | 缺少 url 参数或非微信文章链接 |
| `5020` | `—` | 抓取失败（环境异常/验证页/超时） |

## 9. 变更日志

- **1.0.0** (2026-05-08)
  - 首次上线
  - 支持Markdown/纯文本输出
  - 图片下载

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/wechat-archive`

Source: `https://apizero.cn/aidocs/wechat-archive/raw.md`
Last updated: 2026-05-11T16:16:07+08:00