百度API推送是百度搜索资源平台提供的链接提交方式之一,通过程序自动将网站新产生的链接实时推送给百度,加快收录速度。
详细步骤:
获取权限
注册并登录百度搜索资源平台。
验证网站所有权(如文件验证、HTML标签验证、CNAME验证等)。
在资源平台中,确保拥有该站点的“链接提交”权限。
获取准入密钥(Access Token)
登录资源平台,进入你的站点。
导航到 用户中心
-> 链接提交
-> API提交
。
在“接口调用地址”处,找到 access_token=
后面的字符串(通常是一串长字符),这就是你的准入密钥。请妥善保管。
准备待推送链接
将需要推送的链接整理成一个URL列表。
每条URL必须是已添加到资源平台中的站点的链接,且符合百度收录标准。
URL需完整(包含http://
或https://
),一行一个。
示例 (urls.txt
):
https://www.example.com/page1.html https://www.example.com/news/article123.html https://blog.example.com/post/2023/update
调用推送API(常用方法:curl命令)
-H 'Content-Type:text/plain'
: 设置HTTP请求头,声明发送的是纯文本。
--data-binary @urls.txt
: 指定包含URL列表的文本文件(urls.txt
)。
引号内的地址替换为你的实际接口地址。
将 你的站点域名
替换为你在百度验证通过的完整域名(如 www.example.com
)。
将 你的准入密钥
替换为步骤2中获取的 access_token
值。
推送接口地址: http://data.zz.baidu.com/urls?site=你的站点域名&token=你的准入密钥
使用命令行工具(如终端、命令提示符)执行推送:
curl -H 'Content-Type:text/plain' --data-binary @urls.txt "http://data.zz.baidu.com/urls?site=www.example.com&token=你的准入密钥"
理解API响应
remain
: 当天剩余的可用推送配额。
success
: 本次成功推送并被百度接收的链接数量。
not_same_site
: 提交的链接不属于你在API参数 site=
中指定的站点域名(或子域名)。
not_valid
: 提交的链接格式不合法(如缺少协议头、包含非法字符等)。
执行推送命令后,百度服务器会返回一个JSON格式的响应,包含推送结果信息。常见响应示例:
{ "remain": 4999998, // 当天剩余可推送额度 "success": 2, // 成功推送的链接数量 "not_same_site": [], // 不属于该站点的链接列表(推送失败) "not_valid": [] // 不合法的链接列表(推送失败) }
关键字段:
重要注意事项:
配额限制: 普通站点通常有 每日10万条 的推送配额。配额每天0点重置。推送成功数达到配额上限后,当天无法再推送。remain
字段显示剩余额度。
推送内容:
仅推送 新产生 的、希望百度尽快收录的链接。已推送过且百度已收录的链接无需重复推送。
推送链接