做网站的多少都听过"API推送收录"这回事：程序写好后，每发一篇文章就自动告诉百度"我这里更新了，来抓"。听起来很省事，可真去操作的人，多数卡在同一个地方——入口到底在哪？搜出来的教程有的说是站长平台，有的说是数据开放接口，有的干脆甩一句"获取token"，token又是从哪冒出来的？这篇文章把入口位置、token出处、提交地址格式、配额规则一次拆开讲，你照着操作，从注册到跑通自动推送用不了一小时。
先给个定位：百度收录提交的API入口不在什么独立网站，就在搜索资源平台（ziyuan.baidu.com）后台的"普通收录"里，叫"主动推送（实时）"。整个流程不花一分钱，需要准备的东西只有两样——验证过的站点、一个token。看懂这句话，你就已经知道入口在哪了，剩下的是把每个步骤走通。
一、登录后台之后，入口在"普通收录"里
打开 ziyuan.baidu.com，用百度账号登录，进入搜索资源平台。如果你的站点还没被管理，先在"站点管理"里添加并完成验证——验证方式一般是文件验证、HTML标签验证或DNS验证，选最简单的那个，几分钟就能过。验证通过的站点，左侧菜单里才会出现完整的收录功能。
入口的具体路径是：站点管理 → 选中你的站点 → 普通收录 → 主动推送（实时）。这个页面下方会显示两样关键东西：一是"API接口调用地址"，二是"token"。很多人找了半天找不到API入口，是因为误以为它藏在"快速收录"或"sitemap"里——API主动推送挂在"普通收录"下，和手动提交、自动推送是并列的三个选项，容易看漏。
入口记忆口诀：先验证站点，再点普通收录，最后找"主动推送（实时）"。记住了这个顺序，以后换新站也不会迷路。如果你在后台找不到"普通收录"菜单，先确认站点验证是不是真的通过了。
二、API推送和另两种提交方式差在哪
百度收录提交一共有三条路：手动提交、自动推送、主动推送（API）。它们的目的相同——告诉百度有新页面了，但调用方式完全不同，选错等于白忙。
| 提交方式 | 怎么触发 | 适合谁 |
|---|---|---|
| 手动提交 | 登录后台，把链接一条条粘贴进去 | 页面少、更新慢的个人站 |
| 自动推送 | 在页面里装一段JS，有人访问时自动上报 | 任何网站，装上就生效 |
| 主动推送（API） | 程序调用接口，主动把新链接推给百度 | 有开发能力、内容自动生成的站 |
一句话理解：自动推送是"被动等访问"，API推送是"主动喊人来"。三种方式可以同时开，互不冲突。API推送最大的价值在于它不需要人守着后台——内容一发布，程序顺手就把链接推了，一次设置，长期生效。
三、token是什么，从哪拿，丢了怎么办
token可以理解成你家网站的"门禁卡"，证明"这条推送请求是我本人发的"。没有token，任何人都能往你的站点名下塞链接，所以token务必当密码一样保管，不要写进公开的代码仓库、不要贴到论坛求助帖里。
token就在上一节说的"主动推送（实时）"页面里，一般是一长串字母数字。不同站点、不同时间生成的token都不一样。如果怀疑token泄露了，可以在后台重置，重置后旧token立即失效，程序里要同步换成新的，否则推送会一直报401。
防盗提醒：token和site参数是配套使用的，site填的是你的域名。只要不把这两样同时泄露出去，别人就算拿到半个也用不上。定期重置token是个好习惯，尤其是网站换了开发、换了外包公司之后。
四、提交地址长什么样，一行代码怎么推
拿到token后，提交地址的格式是固定的：
https://data.zz.baidu.com/urls?site=你的域名&token=你的token
调用方式很简单：向这个地址发送一个POST请求，请求体里放你要推送的链接，一行一个。下面是常见的curl写法：
curl -H "Content-Type:text/plain" --data-binary @urls.txt \"https://data.zz.baidu.com/urls?site=你的域名&token=你的token"
其中urls.txt是存放链接的文本文件，每行一条，包含协议头（https://）。也可以用JSON数组格式，把Content-Type改成application/json，请求体是 ["https://你的域名/a.html","https://你的域名/b.html"] 这种形式。两种格式二选一，别混着用。
五、返回的JSON怎么读，报错怎么查
推送成功后，接口会返回一段JSON，正常情况下长这样：
{"remain": 4980, "success": 2}success表示本次成功推送了几条，remain表示当天剩余可推送的数量。如果推送失败，返回里会出现错误信息，最常见的几种：
- 401：token不对或已失效，去后台重新核对，注意别把空格一起复制了。
- 400：请求格式不对，检查Content-Type和请求体格式。
- 403：站点验证信息异常或配额权限不足，回站点管理看验证状态。
- not_same_site：推送的链接和site参数里的域名对不上，比如site填了www开头的，链接却是裸域。
- not_valid：链接格式不合法，少写了协议头，或者链接本身打不开。
看到报错别慌，绝大多数问题出在token多复制了字符、域名带不带www不一致这两处。先自查这两点，能解决一大半。
六、一天到底能推多少条，配额怎么涨
API推送是有配额限制的，不是想推多少推多少。新站点验证通过后，配额通常从比较低的数量起步，每天能推几十条到几百条不等，具体以后台"主动推送（实时）"页面显示为准。配额用完了，当天的推送会被拒收，第二天零点恢复。
配额的涨跌和站点健康度直接挂钩：页面能正常访问、内容有质量、推送后确实被收录，配额会逐步上调；反过来，如果站点频繁报错、推送一堆打不开的页面、内容大量重复，配额会被压下来。也就是说，API推送不是"推得越多收录越多"，而是"站点越好，配额越宽裕"，方向别搞反了。
关于提升配额：后台有配额申请入口，但提交前先看看自己站点的收录率。收录率高、数据健康，申请才容易被批；如果你自己都知道有一堆页面没收录，先把内容质量弄好再申请，成功率更高。
七、什么网站适合用API推送，什么情况用不上
API推送听着高级，但它有前提——你得有程序能调用接口。对号入座看看自己属于哪种：
| 网站情况 | 推荐方式 | 原因 |
|---|---|---|
| 内容由程序自动生成、批量发布 | API推送 | 发布和推送可以写在一个流程里，全自动 |
| 有开发能力、更新频率高 | API推送 | 省掉每天登录后台手动粘贴 |
| 普通个人站、更新不频繁 | 自动推送JS或手动提交 | 装段JS就能覆盖，没必要上API |
有个认知要摆正：API推送不会让收录变快、排名变高，它的作用纯粹是"省人力"。搜索引擎判定一个页面值不值得收录，看的还是内容本身和站点质量。所以别指望"接了API就等于进了快速通道"——把它当成一个顺手的事，而不是一个神奇的功能。
八、容易踩的几个坑，提前绕开
- 把token写进公开代码：代码传到开源平台或外包交付文档里，等于把门禁卡贴在门口。用环境变量或配置文件管理token，别写死在代码里。
- 推送一堆没收录价值的页面：后台页、标签页、空页面推上去，只会拉低站点健康度，配额越推越少。
- 短时间高频重复推送同一批链接：内容没更新就反复推，容易被判定为恶意抓取，得不偿失。
- site参数和链接域名不一致：www和不带www混着写，报错一堆还找不到原因。统一全站只用一个主域名。
- 把配额当成任务量：有些人每天非要推满配额才安心，其实新内容才值得推，没更新就别硬推。
九、从零跑通API推送，就这三步
第一步，验证站点拿token：登录搜索资源平台，添加站点并完成验证，进"普通收录 → 主动推送（实时）"，复制token和接口地址。
第二步，写个脚本调通接口：先用curl手动推一条真实链接，确认返回success后再把它改成程序代码，嵌入你的发布流程。发布完成的那一刻顺手推一次，比定时任务更及时。
第三步，定期看数据：每隔几天到搜索资源平台看索引量变化，用 site:你的域名 自己搜一下收录了多少页。索引在涨、报错在变少，说明这条路走对了；长时间没变化，回头检查是不是配额用尽或链接有问题。
如果你用的是自助建站平台，很多平台后台已经内置了搜索资源平台的提交功能，绑个账号就能自动同步，不需要自己写接口——先看看自己平台的设置里有没有这个入口，能省不少事。
最后说一句：API入口不难找，难的是把它当成一个"通知工具"而不是"作弊工具"。入口位置、token、提交格式都是固定流程，一次配置终身受益；真正决定收录的，还是你每天发的内容值不值得收录。把API装好，把内容做好，剩下的交给时间。
