The API is deliberately small: one endpoint, two methods.<\/p>\n
GET https:\/\/yandex.com\/indexnow?url=<String>&key=<String>[&keyLocation=<String>]<\/code><\/pre>\nurl<\/code> and key<\/code> are required; keyLocation<\/code> only when the key file is not in the root. The URL must comply with RFC 3986.<\/p>\nMany URLs \u2014 POST<\/h2>\nPOST https:\/\/yandex.com\/indexnow\nContent-Type: application\/json; charset=utf-8\n\n{ \"host\": \"www.example.com\",\n \"key\": \"\u2026\",\n \"keyLocation\": \"https:\/\/www.example.com\/key.txt\",\n \"urlList\": [ \"https:\/\/www.example.com\/url1\", \u2026 ] }<\/code><\/pre>\nUp to 10,000 URLs per request.<\/strong> host<\/code>, key<\/code> and urlList<\/code> are required.<\/p>\nResponse codes worth handling<\/h2>\n\n- 200 OK<\/strong> \u2014 accepted.<\/li>\n
- 202 Accepted<\/strong> \u2014 new key awaiting verification. Not an error; keep submitting.<\/li>\n
- 400<\/strong> \u2014 invalid parameters in the body.<\/li>\n
- 403 Invalid key<\/strong> \u2014 the key could not be loaded, or does not match the submitted URLs. On a directory-scoped key this is usually a scope violation rather than a wrong key.<\/li>\n
- 405<\/strong> \u2014 only GET and POST are supported.<\/li>\n
- 422<\/strong> \u2014 the large family: invalid key location, invalid URL, key too short or too long, invalid characters, missing key, host or URL, more than 10,000 URLs,
urlList<\/code> not an array or empty.<\/li>\n- 429 Too Many Requests<\/strong> \u2014 the per-IP limit was exceeded.<\/li>\n<\/ul>\n
Rate limiting<\/h2>\n
Yandex states there is no limit on the number of requests<\/strong> and that its algorithms prevent excessive submission \u2014 while also documenting 429<\/code>. Read together: submit as changes happen, batch where you can, and treat 429 as back-pressure requiring a retry with backoff rather than as a failure.<\/p>\nImplementation notes<\/h2>\n
Distinguish 202 from 200 in logs so a new key is not mistaken for a broken one; treat 422 as a permanent fault requiring a fix rather than a retry; and batch changes into a single POST rather than firing a GET per page, which is what usually triggers 429 on a busy publishing system.<\/p>\n","protected":false},"excerpt":{"rendered":"
The API is deliberately small: one endpoint, two methods. One URL \u2014 GET GET https:\/\/yandex.com\/indexnow?url=<String>&key=<String>[&keyLocation=<String>] url and key are required; keyLocation only when the key file is not in the root. The URL must comply with RFC 3986. Many URLs \u2014 POST POST https:\/\/yandex.com\/indexnow Content-Type: application\/json; charset=utf-8 { “host”: “www.example.com”, “key”: “\u2026”, “keyLocation”: “https:\/\/www.example.com\/key.txt”, “urlList”: […]<\/p>\n","protected":false},"menu_order":95,"template":"","meta":{"footnotes":""},"ar_ykb_kategori":[766],"ar_ykb_etiket":[],"class_list":["post-28519","ar_ykb","type-ar_ykb","status-publish","has-post-thumbnail","hentry","ar_ykb_kategori-indexnow"],"_links":{"self":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_ykb\/28519","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_ykb"}],"about":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/types\/ar_ykb"}],"version-history":[{"count":2,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_ykb\/28519\/revisions"}],"predecessor-version":[{"id":29124,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_ykb\/28519\/revisions\/29124"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/media\/28901"}],"wp:attachment":[{"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/media?parent=28519"}],"wp:term":[{"taxonomy":"ar_ykb_kategori","embeddable":true,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_ykb_kategori?post=28519"},{"taxonomy":"ar_ykb_etiket","embeddable":true,"href":"https:\/\/alienroad.com\/wp-json\/wp\/v2\/ar_ykb_etiket?post=28519"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}