---
name: indexnow
description: Set up IndexNow so Bing and other participating search engines learn about new, changed and deleted URLs at once. Use when a user wants faster discovery in Bing and Copilot, or after a large site change.
---

# IndexNow

## Facts to use
- IndexNow is a protocol to tell participating search engines that a URL changed. Microsoft Bing takes part. Participating engines share submitted URLs with each other. Google is not listed as a participant on indexnow.org.
- The site hosts a key file: a UTF-8 text file at the root, for example `https://example.com/<key>.txt`, that contains the key. A key file in a subfolder (named with `keyLocation`) covers only URLs in that folder.
- One POST can submit up to 10,000 URLs for one host.
- Submit URLs when they are added, updated or deleted. Do not resubmit URLs that did not change.

## Workflow
1. Generate a key (8 to 128 characters: letters, digits and dashes).
2. Publish `/<key>.txt` with the key as its only content. Check that it returns 200.
3. Submit changed URLs:
   ```bash
   curl -X POST "https://api.indexnow.org/indexnow" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d '{"host":"example.com","key":"YOUR_KEY","keyLocation":"https://example.com/YOUR_KEY.txt","urlList":["https://example.com/pricing"]}'
   ```
4. 200 means the URLs were received. 202 means they were received and the key check is pending. 400 means the request format is wrong. 403 means the key is not valid (key file not found, or the key is not in the file). 422 means a URL does not belong to the host, or the key does not match the protocol. 429 means too many requests (possible spam).
5. Automate: call the endpoint from the deploy pipeline or CMS publish hook with only the changed URLs.
6. Check the IndexNow page in Bing Webmaster Tools for received URLs.

## Output
The key file path, the automation code, and the response codes from a test submit.

## Sources
- IndexNow documentation. https://indexnow.org/documentation
- IndexNow: Documentation for search engines. https://indexnow.org/searchengines
