核心结论

百度站长工具 API 提交教程的核心流程是:在百度搜索资源平台完成站点验证,进入普通收录或链接提交页面获取 token,然后向接口 POST 每行一个 URL 的文本。提交成功只代表接口接收了请求,不代表一定收录。接口地址、配额和返回字段可能调整,操作时以百度搜索资源平台链接提交入口的说明为准。

API提交是什么

API提交是指通过 HTTP 请求把站点 URL 批量发送给百度搜索资源平台,属于链接提交方式之一。百度站长工具是旧称,现在通常称为百度搜索资源平台。平台提供普通收录、主动推送、sitemap 等提交方式;不同账号可见的提交类型和配额可能不同。

它解决的是“程序化、批量通知新 URL”的问题,适合内容更新频繁、需要接入发布流程的站点。它不替代站点质量、抓取预算和索引策略,也不能承诺收录时间。

提交前准备

  • 注册并登录百度搜索资源平台。
  • 添加站点并完成验证,确保提交 URL 与验证站点一致。
  • 确认站点可正常访问,返回 200 状态码,避免提交登录页、404 页或参数重复页。
  • 准备可公开访问的 URL 清单,并去掉重复、带会话参数和无关跟踪参数的链接。

获取 token 与接口地址

进入普通收录或链接提交页面后,平台会给出接口地址和 token。常见接口形式为 http://data.zz.baidu.com/urls?site=你的站点&token=你的token,但应以页面实际显示为准。token 相当于提交凭证,不要写入公开仓库、前端代码或截图。

建议把站点域名、token 放入服务端环境变量,由发布系统调用。若 token 泄露,应立即在平台重置,并检查提交记录是否异常。

curl 示例

先准备 urls.txt,每行一个完整 URL,然后执行:

curl -X POST 'http://data.zz.baidu.com/urls?site=你的站点&token=你的token' \
-H 'Content-Type: text/plain' \
--data-binary @urls.txt

示例中的站点、token、URL 均为占位符。实际使用时替换为你自己的站点和凭证,并控制单次提交数量,避免超过页面显示的配额。

Python 示例

import requests

url = 'http://data.zz.baidu.com/urls?site=你的站点&token=你的token'
urls = ['https://www.example.com/a', 'https://www.example.com/b']
headers = {'Content-Type': 'text/plain'}
resp = requests.post(url, data='\n'.join(urls).encode('utf-8'), headers=headers, timeout=10)
print(resp.status_code)
print(resp.text)

生产环境应加入失败重试、日志记录和配额控制。不要把提交失败简单当成“接口坏了”,先看 HTTP 状态码和返回 JSON。

返回字段怎么读

接口通常返回 JSON。常见字段可能包括 success、remain、not_same_site、not_valid,分别对应成功接收数量、剩余配额、非本站 URL 和无效 URL。具体字段和含义以你账号页面及实际返回为准,不要把某个字段的解释当成永久不变的官方定义。

  • success:本次被接口接收的 URL 数量。
  • remain:当天还可能剩余的提交额度,按平台显示为准。
  • not_same_site:与验证站点不一致的 URL。
  • not_valid:格式或状态不符合要求的 URL。

常见错误与排错

  • token 错误:检查是否复制完整,是否与当前站点匹配。
  • 站点不一致:提交 URL 的域名必须属于已验证站点,子域名和协议要核对。
  • URL 格式错误:使用完整 URL,每行一个,避免空格和多余标点。
  • 配额已满:降低提交频率,优先提交新页面和重要页面。
  • Content-Type 不正确:API提交通常使用 text/plain,按页面示例设置。
  • 提交成功但未收录:检查页面质量、抓取状态、内链和重复内容,不要反复提交同一批 URL。

与 sitemap、主动推送的关系

API提交适合程序化批量通知;sitemap 适合提供全站 URL 清单;主动推送是平台提供的另一种提交思路。三者不是互相替代的“保证收录”工具,通常需要结合站点结构、更新频率和抓取情况使用。若站点已有稳定 sitemap,API提交可作为新内容发布后的补充。

如何验证

提交后不要只看接口返回。建议在平台查看提交记录、抓取诊断和索引表现,并结合站点日志观察百度蜘蛛是否抓取。搜索指令只能作为粗略参考,不能等同于官方收录数据。

FAQ

API提交能保证收录吗?不能。它是通知入口,不是收录承诺。

token 可以放在前端吗?不建议。token 泄露后可能被滥用,应放在服务端。

提交成功但没收录怎么办?先检查页面是否可访问、是否有价值、是否重复,再检查内链和抓取情况,不要只增加提交次数。

普通收录和快速收录一样吗?不一样,权限和入口可能不同,以账号页面为准。

来源与更新

本文操作入口以百度搜索资源平台链接提交入口和百度搜索资源平台为准。百度可能调整接口、配额和字段,执行前请以登录后页面说明为准。本文不提供虚假测试数据,也不声称提交必然提升排名或收录。