获取微信公众号文章列表

POST

https://api.getoneapi.com/api/wechat-mp-v2/fetch_mp_article_list

手动翻页：首页 offset 留空 → 从响应取 next_offset（base64 游标）→ 下次请求放进 offset 取下一页；is_end 为真即末页。

由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。

请求参数

Header 参数

Authorization string 必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey

默认值： Bearer YOUR_API_KEY

Content-Type string 必需

默认值： application/json

Body 参数

application/json

username string 公众号原始ID 必需

gh_… 示例：gh_d29e0d22a6f9

page_size integer 每页文章数可选

可选，默认 20，范围 10-20

offset string 翻页游标可选

可选，翻页游标（base64），首页留空；翻页时传上一页响应的 next_offset。示例 CAMQChiS5KfRBiAKOJLkp9EGQABIAVgAYABwAQ==

item_show_type string 可选

可选，内容栏目（对应公众号主页的「文章 / 视频 / 音频」分栏）。留空 / 0=文章（默认）、5=视频、7=音频、8=贴图。默认不传=文章

raw boolean 可选

可选，默认 false。true=原始；false=精简解析。

示例

{
  "username" : "gh_d29e0d22a6f9",
  "page_size" : 20,
  "offset" : "",
  "item_show_type" : 0,
  "raw" : false
}

返回响应

响应 200

application/json

code integer 必需

message string 必需

data object 必需

示例

{
  "code" : 200,
  "message" : "success",
  "data" : { }
}

请求示例代码

替换 YOUR_API_KEY、参数占位符与请求数据后使用。第三方客户端需先安装对应依赖。

curl --globoff --request POST 'https://api.getoneapi.com/api/wechat-mp-v2/fetch_mp_article_list' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "username" : "gh_d29e0d22a6f9",
  "page_size" : 20,
  "offset" : "",
  "item_show_type" : 0,
  "raw" : false
}'

更新于 2026-11-10 19:04:47