Tools

IndexNow submission tester: submit one URL and read the answer

4 min readUpdated

To submit one URL to IndexNow and read what the engine says, enter your hostname, your key and the address, then run the commands this page builds in a terminal. The page itself sends nothing and fetches nothing. The requests come from your machine, so the status code you read is the one the endpoint actually gave.

Build the commands for one URL

Fill in the fields and the three commands below update as you type. Without JavaScript they show placeholders: replace your-host.example, your-key and the address by hand, and add a "keyLocation" field to the body only if your key file is not in the root.

1. Fetch the key file without following redirects

curl -s -g -o /dev/null \
  -w "%{http_code} %{content_type}\n" \
  "https://your-host.example/your-key.txt"

This prints the status code and the content type of the key file. curl does not follow redirects unless told to, and that is the point. A 200 with a plain-text content type is what you want. A 301 or 302 means a redirect caught the request, which a browser would have followed without telling you.

2. Print the file and compare it with the key

curl -s -g "https://your-host.example/your-key.txt"; echo

The output should be the key and nothing else. A page of HTML, or a different string, means the file exists but does not hold the key.

3. Submit the address

curl -i -X POST "https://api.indexnow.org/indexnow" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "host": "your-host.example",
    "key": "your-key",
    "urlList": ["https://your-host.example/changed-page"]
  }'

This one is a real submission. It posts to api.indexnow.org, the shared endpoint described under the request format, and -i prints the response headers, so the first line is the status code. Run it only for a hostname you control.

What this page sends, and what the commands send

It cannot run the checks for you. A browser does not let a page read another site's response unless that site allows it, and it follows redirects silently, so even a permitted request would hide the answer an engine gets. The key checker explains why that matters, and a terminal has neither limit.

Commands 1 and 2 only request your own key file. Command 3 is a real submission: it asks the endpoint to verify your key and announce the address, one address per request. Google does not take part in IndexNow, so none of the three reaches it.

Reading the result

Command 3 prints an HTTP status line, and the code in it is one of six. IndexNow response codes gives the meaning of each; this is what to do next.

What to do next for each response code command 3 can return
CodeWhat to do next
200Nothing; it is not a report of indexing
202Keep the key file reachable, and run commands 1 and 2 to confirm it is
400Compare the body with the request format
403Run commands 1 and 2, then see key not found and key read but not accepted
422Compare the host with the address, and check the key is 8 to 128 letters, digits and dashes
429Stop, and do not run the command again

A 200 or 202 says the address was received and nothing more. It does not report that the page was crawled or indexed, which is the engine's decision; submitted but not indexed covers what follows. A page missing from Google's index (noindex, a robots.txt block, “crawled – currently not indexed”) is a separate matter, because Google does not take part in IndexNow; see Bridge CDN.

Before you run the submission

Work in this order. Make a key with the IndexNow key generator, publish the file, and run commands 1 and 2 until they show the key. Only then run command 3. A 403 on the first try usually means the file was not reachable yet, and commands 1 and 2 show directly whether it was.

Run command 3 once per change. An address sent again without having changed claims a change that did not happen, and a 429 is the engine saying the site has reached its limit. The protocol's guidance is to wait at least five minutes between submissions of the same address. Engines do not publish their limits, so there is no count to stay under.

FAQ

How do I test an IndexNow submission?

Build the commands on this page, check that your key file answers with the key (commands 1 and 2), then run command 3 from a terminal and read the status code on its first line. A 200 or 202 means the address was received.

Can I submit a URL for a site I do not control?

No. A submission has to be backed by a key file served from that site's hostname, which only whoever controls the hostname can arrange, so the endpoint refuses it. Run command 3 only for hostnames you control.