知识库首页 SEO url-submission-api.md

url submission api

本地来源:SEO/seo方法论/bing-seo/url-submission-api.md

Bing URL Submission API

来源:https://www.bing.com/webmasters/url-submission-api

概述

Bing URL Submission API(又称 Adaptive URL Submission API)是 Bing Webmaster Tools 提供的一项免费功能,允许网站所有者主动向 Bing 提交新增或更新的 URL,无需等待 Bingbot 自然爬取发现。自 2019 年推出以来,已有数千个网站采用此 API,提交了数百万个 URL 用于索引。

需要注意的是,此 API 仅向 Bing 提交 URL,不会通知其他搜索引擎。如需同时通知多个搜索引擎,推荐使用 IndexNow 协议。截至 2025 年,Microsoft 官方已建议将 IndexNow 作为实时 URL 提交的首选方法,但 Adaptive URL Submission API 仍然支持高级用例和自定义平台集成。

核心功能

  • 单 URL 提交(Submit URL):逐个提交单条 URL,适合少量内容更新场景
  • 批量 URL 提交(Submit URL Batch):一次性提交多条 URL,适合大规模内容发布
  • 配额查询(Get URL Submission Quota):查询当前账户的每日剩余提交配额
  • 即时索引:提交的 URL 可被 Bing 立即抓取和索引,无需等待自然爬取周期
  • Content Submission API(Beta):高级功能,允许直接向 Bing 推送页面内容本身

使用说明

前置准备

  1. 注册并登录 Bing Webmaster Tools
  2. 添加并验证你的网站
  3. 前往 Webmaster API > Generate 获取 API Key

API 调用方式

API 支持所有主流编程语言调用(C#、Python、PHP 等),也可使用 cURL 快速测试。

单 URL 提交示例:

POST https://ssl.bing.com/webmaster/api.svc/json/SubmitUrl?apikey=YOUR_API_KEY
Content-Type: application/json

{
  "siteUrl": "https://example.com",
  "url": "https://example.com/new-page"
}

批量 URL 提交示例:

POST https://ssl.bing.com/webmaster/api.svc/json/SubmitUrlBatch?apikey=YOUR_API_KEY
Content-Type: application/json

{
  "siteUrl": "https://example.com",
  "urlList": [
    "https://example.com/page1",
    "https://example.com/page2",
    "https://example.com/page3"
  ]
}

查询配额示例:

GET https://ssl.bing.com/webmaster/api.svc/json/GetUrlSubmissionQuota?siteUrl=https://example.com&apikey=YOUR_API_KEY

生产环境建议

  • 使用服务端脚本或应用程序处理认证、批量提交和错误处理
  • cURL 仅建议用于快速测试或原型验证
  • 建议每天至少刷新一次 Sitemap,帮助 Bing 发现所有相关 URL

关键信息

项目 详情
每日提交限额 最多 10,000 个 URL/天
配额重置时间 每天 GMT 午夜(北京时间早 8 点)
认证方式 API Key(从 Bing Webmaster Tools 生成)
费用 免费
替代方案 IndexNow(推荐,支持多搜索引擎通知)
适用场景 新闻发布、博客更新、电商产品上架等时效性内容

IndexNow vs URL Submission API

对比项 IndexNow URL Submission API
通知范围 多搜索引擎(Bing、Yandex 等) 仅 Bing
实现方式 简单 API 调用或 CMS 插件 API 调用
生态支持 WordPress、Wix、GitHub 等原生支持 需自行集成
官方推荐 当前首选方案 高级/自定义场景使用

重要提示

  • Bing Search API 和 Custom Search API 将于 2026 年 8 月 11 日退役,但这与 URL Submission / Webmaster API 是不同的产品,后者不受影响
  • 完整 API 文档参见 Microsoft Learn - Bing Webmaster API

本文档为站内渲染。原始文件本地路径:saas/source/seo/SEO-seo方法论-bing-seo-url-submission-api-8b75aa.md(仅本地保留,不入库不部署)