Get the IndexNow key for a host, creating it on first use, and the URL where its key file must be hosted.

POSThttps://api.rankparse.com/v1/indexnow/keyFreeAPI key

Returns your workspace's IndexNow key for a host, creating it the first time. The key never changes, so calling again returns the same key and a key file you have already published stays valid. Host the key file at key_location before you submit URLs.

Query parameters

domainstringrequired

The host to get a key for, for example example.com or blog.example.com. A bare hostname only: no scheme, path or port. It must contain a dot and be a public host. It is lowercased. Anything else returns 400 invalid_domain.

example.com and www.example.com are different hosts and get different keys. Create the key for the exact host that appears in the URLs you will submit.

Response

201 Created when this call created the key, 200 OK on every later call for the same host. The body is a plain object, not wrapped in data.

hoststring

The normalized host.

keystring

The key: 32 lowercase hexadecimal characters.

key_locationstring

Where the key file must be hosted: https://<host>/<key>.txt.

verifiedboolean

true when RankParse confirmed the hosted key file within the last 24 hours.

instructionsstring

A one-line summary of the hosting step.

The key file contains the key and nothing else. Leading and trailing whitespace, such as a final newline, is ignored when RankParse checks it. See Key file verification.

Behavior and limits

Cost: 0 credits.
Idempotent: concurrent first calls for the same host converge on one key.
No website check here: a key can be created for any public host, but Submit URLs only accepts hosts that are one of your websites or a subdomain of one.
Rate limit: 60 requests per minute per key. See Rate limiting.

Errors

HTTP	Code	When
400	`invalid_domain`	`domain` is missing, not a bare hostname, or not a public host.
401	`invalid_api_key`	Missing, invalid or revoked API key.
403	`capability_missing`	Your workspace role cannot spend credits (`credits.spend`).
429	`rate_limited`	More than 60 requests in a minute.

See Errors for the error body format.

MCP tool: provision_indexnow_key (accepts domain). On the API-key MCP server only.

IndexNow

How keys, verification and submission fit together.

Submit URLs

Send up to 1000 changed URLs from one host.

curl -X POST "https://api.rankparse.com/v1/indexnow/key?domain=example.com" \
  -H "X-API-Key: rp_your_key"

201 Response

{
  "host": "example.com",
  "key": "3f9a1c7e2b8d4e6f9a0b1c2d3e4f5a6b",
  "key_location": "https://example.com/3f9a1c7e2b8d4e6f9a0b1c2d3e4f5a6b.txt",
  "verified": false,
  "instructions": "Host a UTF-8 text file containing exactly the key at https://example.com/3f9a1c7e2b8d4e6f9a0b1c2d3e4f5a6b.txt, then submit URLs with POST /v1/indexnow."
}

Create an IndexNow key

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

Behavior and limitsCopy Anchor Link

ErrorsCopy Anchor Link

RelatedCopy Anchor Link