跳到主要内容

百度普通收录 API:从手动提交到脚本自动跑

手动提交 URL 费时还容易漏。我们把百度普通收录 API 接进发布流程,每天自动推 30 条,半年省下约 40 小时。接口用法、提交策略、常见错误码和踩过的坑,这篇一次讲完,最后一节是我们半年后的复盘,照着做能省出每周一小时。

技术SEO 元析智能

手动提交 URL 费时还容易漏。我们把百度普通收录 API 接进发布流程,每天自动推 30 条,半年省下约 40 小时。接口本身很简单,难在提交策略。

接口长什么样

百度普通收录 API 是一个 HTTP 请求,site 和 token 在搜索资源平台后台拿:

curl -H 'Content-Type:text/plain' \
  --data-binary @urls.txt \
  'http://data.zz.baidu.com/urls?site=https://www.example.com&token=xxx'

urls.txt 一行一条 URL,返回 JSON,里面有本次成功条数和剩余配额。就这么点东西,20 行脚本能跑通。

我们的脚本怎么跑

发布流程里加一步:新内容上线后,脚本从数据库取当天新增的 URL,过滤掉重复提交过的,拼成 urls.txt,调接口,把返回结果记日志。

两个细节。一是去重表,同一个 URL 只推一次,重复推不增加收录,还浪费配额。二是失败重试,接口偶尔超时,脚本第二天自动补推,不人工介入。

提交策略:只推这四类 URL

配额有限,什么 URL 都推等于没推。我们只推四类:新发布的文章、新上线的产品页、有搜索需求但还没收录的页面、更新过核心内容的老页面。

不推的:分类页、标签页、分页、搜索结果页、参数页。这些页面推了也大概率不收,收了也是低质页面。

快速收录和普通收录别搞混

搜索资源平台里有两个接口:普通收录和快速收录。快速收录不是所有站都有,需要站点有相应权益,别照着旧教程硬调,调不通先看后台有没有这个入口。

普通收录是保底的。我们所有站都接普通收录,快速收录只给有权益的站配,两者不冲突。

常见错误码

返回 401 是 token 不对;403 是配额用完或者站点没验证;400 常见于 URL 格式错误,比如带空格、没写协议头。

还有一个坑:同一批里有一条 URL 格式不对,整批可能失败。我们的脚本会先做格式校验,再提交。

效果和一个提醒

2025 年 8 月接入,到今年 1 月正好半年。一个 800 页的站,接 API 之前手动提交,一周推 60 条左右,收录周期 5 到 9 天。接完之后每天推 30 条,收录周期缩到 3 到 6 天,人工投入几乎为零。

提醒一句:提交只是告知,不是保证收录。我们见过客户每天推满配额,收录率还是不到 30%,问题在页面质量,不在接口。先把页面做好,再用 API 提效,顺序别反。

半年复盘:这个站的人工提交时间从每周 70 分钟降到 5 分钟,收录周期稳定在 3 到 6 天。今天这篇就是脚本自动推的,推完 4 天收录。对一个日更的站,这个时间差会放大,人工根本盯不过来。

标签:百度收录API自动化
元

元析智能

为软件公司做 SEO 和 GEO 优化

Start with a diagnosis

聊聊你的软件产品

不管你现在是 SaaS、开发者工具还是工程设计软件,只要你想让目标客户搜得到你,我们可以聊。第一次沟通不收费,会给你一份当前的 SEO 诊断,你能看出问题在哪。