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 of the page for which you want to send the data. Must comply with the RFC3986 standard. |
|
The key verifying the site management rights. When you send a request, the search engine matches this value with the file contents. |
|
Path to the file with the key if it isn't placed in the root directory of the site. |
* Required parameter
Response format
HTTP code 200 OK
content-type: application/json
Other response codes:
Code |
Reason |
Description |
202 |
Accepted |
A new key is awaiting verification. If you’re sure that it’s correct, wait a little while and submit a few other addresses. If the code changes to 200 OK, it means the key is verified and the addresses are submitted. If the code remains 202, the key has not yet been added to the database after verification and you need to wait longer. |
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 |
422 |
Invalid url |
The request contains an invalid URL or the passed key isn't suitable for processing it. |
422 |
The 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 |
422 |
No url provided |
The |
429 |
Too Many Requests |
The number of requests for one IP address is exceeded. |
Questions and answers
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.