Sending one page
Sends the URL of the site page to Yandex with IndexNow protocol support.
Request format
GET https://yandex.com/indexnow
? url=<String>
& key=<String>
& [keyLocation=<String>]
url * | URL of the page for which you want to send the data. Must comply with the RFC3986 standard. |
key * | The key verifying the site management rights. When you send a request, the search engine matches this value with the file contents. |
keyLocation | Path to the file with the key if it isn't placed in the root directory of the site. |
url * | URL of the page for which you want to send the data. Must comply with the RFC3986 standard. |
key * | The key verifying the site management rights. When you send a request, the search engine matches this value with the file contents. |
keyLocation | Path to the file with the key if it isn't placed in the root directory of the site. |
* Required
Response format
HTTP code 200 OK
content-type: application/json
Other response codes:
Code | Reason | Description |
---|---|---|
403 | Invalid key | The key couldn't be loaded or it doesn't match the URLs specified in the request. |
405 | Method not allowed | The GET and POST methods are supported. |
422 | Invalid key location | The keyLocation parameter is specified incorrectly. |
422 | Invalid url | The request contains an invalid URL or the passed key isn't suitable for processing it. |
422 | Key must be at least 8 characters | The key includes less than 8 characters. |
422 | Key must be no longer than 128 characters | The key includes more than 128 characters. |
422 | Key must consist of a-Z0-9 or '-' | The key contains invalid characters. |
422 | No key provided | The key is missing in the request. |
422 | No url provided | The url parameter is missing in the request. |
429 | Too Many Requests | The number of requests for one IP address is exceeded. |
Code | Reason | Description |
---|---|---|
403 | Invalid key | The key couldn't be loaded or it doesn't match the URLs specified in the request. |
405 | Method not allowed | The GET and POST methods are supported. |
422 | Invalid key location | The keyLocation parameter is specified incorrectly. |
422 | Invalid url | The request contains an invalid URL or the passed key isn't suitable for processing it. |
422 | Key must be at least 8 characters | The key includes less than 8 characters. |
422 | Key must be no longer than 128 characters | The key includes more than 128 characters. |
422 | Key must consist of a-Z0-9 or '-' | The key contains invalid characters. |
422 | No key provided | The key is missing in the request. |
422 | No url provided | The url parameter is missing in the request. |
429 | Too Many Requests | The number of requests for one IP address is exceeded. |
FAQ
How often can I send requests?
There is no limit on the number of requests, you can adjust their frequency yourself. Yandex uses algorithms that prevent too many requests.
Can I send the same URL multiple times a day?
We don't recommend sending the same URL too often. If necessary, send it with pauses (10 minutes). If the page is updated frequently, use other ways to report this to Yandex.
Can I send pages with HTTP code 404 via the API?
Yes, you can use IndexNow to report pages with a 404 or 410 code.
Can I send pages with the HTTP code 301 or 302 (redirection)?
Yes, you can send URLs with information about redirects or other changes.