# 公众号的原始 ID（gh_ 开头）是什么？

> 原始 ID 是 gh_ 加一串十六进制字符，注册时生成、之后不变。它和微信号、AppID、__biz 有什么区别，接口怎么收、怎么返回它。

网页版：https://okdata.online/zh/answers/wechat-gh-original-id/

**简短回答：**它是账号永久不变的内部名称：gh_ 后面跟一串十六进制字符，通常 12 位，比如 gh_7a41c09e2b5d，注册时生成，之后不能改。它不像微信号那样可以修改，也不像 AppID 那样是开发者凭证。okdata 的公众号搜索把它作为 id 返回（每个搜到的号 $0.058），历史文章接口用它列出文章，每页 $0.02。

每个公众号注册时都会拿到一个原始 ID：字母 `gh_` 后面跟一串十六进制字符，通常是 12 位，比如 `gh_7a41c09e2b5d`。号主在 mp.weixin.qq.com 后台的账号设置里能看到它，在注册信息那一栏，写作“原始ID”。读者几乎看不到它，所以投放方案里列的一串公众号名称，没法直接导进监测工具：这些工具都以 gh_ ID 为主键，因为它是唯一永远不变的标识。名称可以改，微信号可以后设、可以改，原始 ID 却跟着账号一辈子。

## 四种账号标识

| 标识 | 长什么样 | 谁定的 | 会不会变 | 用在哪里 |
|---|---|---|---|---|
| 原始 ID | `gh_7a41c09e2b5d` | 微信，注册时生成 | 不会 | 监测工具、历史文章、第三方数据 |
| 微信号 | `brand_news` | 号主自己，可不设 | 可以后设 | 告诉别人怎么搜到这个号 |
| AppID | `wx` 开头 | 微信，给开发者的 | 不会 | 调用微信官方接口操作自己的号 |
| `__biz` | `MzA5NTI3MjIwMA==` | 微信 | 不会 | 文章和主页的网页链接，见 [__biz 是什么](/zh/answers/wechat-biz-parameter/) |

有两点要留意。gh_ 开头不代表一定是公众号：小程序也有同样 `gh_` 格式的原始 ID，微信官方文档里网页跳转小程序时要填的就是小程序的 gh_ ID。另外，AppID 是你自己账号的开发凭证，不能拿来查别人的号。

## 接口怎么收、怎么返回

- [公众号搜索](/zh/apis/wechat_mp/accounts/search/)按名称或关键词找号，每个结果带 `id`（gh_ ID）、`username`（设置了的话是微信号）和 `name`。按返回的账号数计费。
- [公众号历史文章](/zh/apis/wechat_mp/accounts/articles/list/)用 gh_ ID 或微信号作为 `id`，从新到旧列出已发布的文章。它不认 `__biz`。
- [文章详情](/zh/apis/wechat_mp/articles/get/)对任意文章链接返回 `author.id`，也就是发文账号的 gh_ ID。

| 任务 | 调用次数 | 费用 |
|---|---|---|
| 名称换 gh_ ID | 1 | 每个返回的号 $0.058，最多 $0.58 |
| 一条文章链接换发文账号的 gh_ ID | 1 | $0.02 |
| 某个 gh_ ID 最新 10 篇文章 | 1 | $0.02 |

## 示例

```bash
curl -G "https://api.okdata.online/v1/wechat_mp/accounts/articles/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=gh_7a41c09e2b5d' \
  --data-urlencode 'fields=id,title,published_at,url'
```

## 限制

- 做过账号迁移的公众号，迁移后原始 ID 会变成新号的。存着的 gh_ ID 突然拉不到新文章，就按名称重新搜一次。
- 常见名称可能搜出好几个长得像的号，存 ID 之前先核对 `name`。
- 把一批名称换成 gh_ ID，或者免费从文章网页源码里找，见[查公众号的 biz 和原始 ID](/zh/answers/find-wechat-official-account-id/)；整号导出见[导出公众号全部文章](/zh/answers/export-wechat-official-account-articles/)。

## 用到的接口

- [公众号搜索](https://okdata.online/zh/apis/wechat_mp/accounts/search/) `wechat_mp.accounts.search`：$0.058/条 · 每次最多 $0.58
- [公众号历史文章](https://okdata.online/zh/apis/wechat_mp/accounts/articles/list/) `wechat_mp.accounts.articles.list`：$0.02/次 · 每页约 10 篇文章
- [公众号文章详情](https://okdata.online/zh/apis/wechat_mp/articles/get/) `wechat_mp.articles.get`：$0.02/次

## 更多微信公众号内容

- [微信公众号 API](https://okdata.online/zh/apis/wechat_mp/)
- [公众号 API Python 教程：把文章转成 Markdown 给 RAG 用（2026）](https://okdata.online/zh/guides/wechat-official-account-api-python/)
- [怎么拿到一个公众号的历史文章和全文](https://okdata.online/zh/guides/wechat-official-account-articles/)
- [为什么 ChatGPT、Claude 打不开公众号文章链接？怎么让 AI 读到全文？](https://okdata.online/zh/answers/ai-read-wechat-article-link/)
- [怎么不登录导出一个公众号的全部历史文章？](https://okdata.online/zh/answers/export-wechat-official-account-articles/)
- [怎么监控竞品公众号每天发了什么？](https://okdata.online/zh/answers/monitor-competitor-wechat-official-accounts/)
- [公众号文章链接里的 __biz 是什么？](https://okdata.online/zh/answers/wechat-biz-parameter/)
- [公众号文章数据 API 多少钱？](https://okdata.online/zh/answers/wechat-official-account-api-price/)
- [平台官方 API 和第三方数据接口怎么选（2026）](https://okdata.online/zh/compare/official-apis-vs-data-apis/)
- [社媒数据 MCP 服务器：自己部署还是用托管的](https://okdata.online/zh/compare/social-media-data-mcp-servers/)
- [公众号文章和阅读数接口有哪些？官方接口、第三方 API、开源工具、数据平台 4 类方案怎么选（2026）](https://okdata.online/zh/compare/wechat-article-data-apis/)
- [获取微信公众号数据的几种办法：官方接口、RSS 桥接和数据接口](https://okdata.online/zh/compare/wechat-official-account-data-apis/)
- [让 AI 读小红书、抖音、公众号的 MCP 有哪些？开源自部署、浏览器自动化、托管 3 类怎么选（Claude、Cursor、豆包）](https://okdata.online/zh/compare/xiaohongshu-douyin-wechat-mcp-servers/)
- [账号作品列表接口](https://okdata.online/zh/roles/accounts-posts-list/)

## 资料来源

- [WeChat open tags (微信开放文档): appid is the ID starting with wx, username the original ID starting with gh_](https://developers.weixin.qq.com/doc/service/guide/h5/opentag.html) (读取于 2026-11-12)
- [Feed request listing an account's name, gh_ ID and biz together (feeddd/feeds issue #3438)](https://github.com/feeddd/feeds/issues/3438) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-12）：

- https://developers.weixin.qq.com/community/personal/oCJUswyaeSsHJf1a36Pk7VXvxtCc/question
- https://github.com/feeddd/feeds/issues/3438

更新于 2026-11-12