Easy set-up guide for Bing’s Content Submission API

⚠️ Note (Updated November 2025):

Microsoft now recommends using IndexNow as the primary method for real-time URL submission to Bing and participating search engines.

IndexNow is simpler to implement, widely supported by many CMS platforms and plugins, and helps ensure your most important content is indexed faster.

The Content Submission API described below remains supported for advanced use cases and custom platform integrations.

*******************************************************************************************************************************

At Bing, webmasters don’t have to wait to get their content crawled and indexed. Bing offers webmasters the ability to tell Bing about the latest changes to their sites, including added, updated or deleted content and URLs.

Bing already supports the ability for webmasters to notify Bing about URL changes via its Bing URL submission API (setup guide) but now also the ability to notify Bing directly about URLs along with content changes via the Bing Content Submission API. 

Step 1: Generate an API Key  

Webmasters need an API key to be able to access and use Bing Webmaster APIs. This API key can be generated from Bing Webmaster Tools by following these steps:  

  1. Sign in to your account on Bing Webmaster Tools. In case you do not already have a Bing Webmaster account, sign up today using your Microsoft, Google, or Facebook account.

  2. Add and verify the site that you want to submit a URL for through the API, if not already done. 

  3. Click on the Settings button on the top right corner of your dashboard, and click on API Access. If you are generating the API key for the first time, click Generate Key to create a new API Key. Otherwise, you will see the key you've previously generated

api-key.png

Note: Please note that the API key is generated for a user and not a site and hence a user can use the same API key for all of their verified sites on Bing Webmaster Tools.You can change your API key anytime, however, you may need to wait up to 30 minutes for the system to generate a new key. 

Step 2:  Integrate with your website and start submitting content

You can use any of the below protocols to easily integrate the Webmaster API SubmitContent method into your system.

XML request sample 

XML
POST /webmaster/api.svc/pox/SubmitContent?apikey=EEDECC1EA4AE341CC57365E075EBC8B6 HTTP/1.1 
Content-Type: application/xml; charset=utf-8 
Host: ssl.bing.com 

<SubmitContent xmlns="http://schemas.datacontract.org/2004/07/Microsoft.Bing.Webmaster.Api"> 
<siteUrl>http://example.com</siteUrl> 
<url>http://example.com/url1.html</url> 
<httpMessage>SFRUUC8xLjEgMjAwIE9LCkRhdGU6IFN1biwgMTAgT2N0IDIwMTcgMjM6MjY6MDcgR01UCkFjY2VwdC1SYW5nZXM6IGJ5dGVzCkNvbnRlbnQtTGVuZ3RoOiAxMwpDb25uZWN0aW9uOiBjbG9zZQpDb250ZW50LVR5cGU6IHRleHQvaHRtbAoKSGVsbG8gd29ybGQh</httpMessage> 
<structuredData></structuredData> 
<dynamicServing>0</dynamicServing>
</SubmitContent>

Note: httpMessage value should be the base64 encoded version 


JSON request sample

POST /webmaster/api.svc/json/SubmitContent?apikey=EEDECC1EA4AE341CC57365E075EBC8B6 HTTP/1.1 
Content-Type: application/json; charset=utf-8 
Host: ssl.bing.com 

{ 
"siteUrl":"http://example.com", 
"url":"http://example.com/url1.html", 
"httpMessage":"SFRUUC8xLjEgMjAwIE9LCkRhdGU6IFN1biwgMTAgT2N0IDIwMTcgMjM6MjY6MDcgR01UCkFjY2VwdC1SYW5nZXM6IGJ5dGVzCkNvbnRlbnQtTGVuZ3RoOiAxMwpDb25uZWN0aW9uOiBjbG9zZQpDb250ZW50LVR5cGU6IHRleHQvaHRtbAoKSGVsbG8gd29ybGQh", 
"structuredData":"", 
"dynamicServing":"0" 
} 

If the URL submission is successful you will receive an http 200 response. If Bing webmaster guidelines are met the pages will be crawled and indexed in real time.

If you face any challenges during the integration, you can reach out at bwtsupport@microsoft.com.

Thanks! 
Bing Webmaster Tools team

Back to
Top