IndexNow Documentation

https://www.indexnow.org/documentation
Admin
IndexNow is a simple way for website owners to quickly inform search engines about new or updated...
Tokens:3,179
Snippets:14
Trust Score:9.7
Update:1 week ago
Show doc for...
Tokens:
Raw
### Example single URL submission with key

Source: https://www.indexnow.org/documentation

Example of notifying that https://www.example.com/product.html has been updated using the key 3c78b3b7cf404670ab10afc5e7e26baa. Replace <searchengine> with the search engine's host. A successful request returns HTTP 200.

```http
https://<searchengine>/indexnow?url=https://www.example.com/product.html&key=3c78b3b7cf404670ab10afc5e7e26baa
```

--------------------------------

### GET /indexnow

Source: https://www.indexnow.org/documentation

Submits a single URL to a search engine using an HTTP GET request. The URL and key are passed as query parameters. A successful request returns HTTP 200.

```APIDOC
## GET /indexnow

### Description
Submits a single URL to a search engine to notify it of a change (added, updated, or deleted). The request is made via HTTP GET with query parameters.

### Method
GET

### Endpoint
https://<searchengine>/indexnow?url=url-changed&key=your-key

### Parameters
#### Query Parameters
- **url** (string) - Required - The URL of your website that has been added, updated, or deleted. Must be URL-escaped and encoded, and follow RFC-3986 standard for URIs.
- **key** (string) - Required - Your key. Must be 8 to 128 hexadecimal characters, containing only lowercase (a-z), uppercase (A-Z), numbers (0-9), and dashes (-).

### Request Example
https://<searchengine>/indexnow?url=https://www.example.com/product.html&key=3c78b3b7cf404670ab10afc5e7e26baa

### Response
#### Success Response (200)
- HTTP 200 indicates the search engine has received your URL.

#### Response Example
HTTP 200
```

--------------------------------

### Submit a single URL with HTTP GET request

Source: https://www.indexnow.org/documentation

Use this URL format to notify a search engine about a single URL change. Replace <searchengine> with the search engine's host. The url parameter must be URL-escaped and RFC-3986 compliant. The key must be 8-128 hexadecimal characters (a-z, A-Z, 0-9, dashes). A successful request returns HTTP 200.

```http
https://<searchengine>/indexnow?url=url-changed&key=your-key
```

--------------------------------

### Submit a set of URLs with POST JSON request

Source: https://www.indexnow.org/documentation

Use this HTTP POST request to submit up to 10,000 URLs at once. Replace <searchengine> with the search engine's host. The JSON body includes the host, key, and urlList. A successful request returns HTTP 200, indicating the search engine received the URLs.

```http
**POST** /indexnow **HTTP**/1.1
Content-Type: application/json; charset=utf-8
Host: <searchengine>
{
  "host": "www.example.com",
  "key": "3c78b3b7cf404670ab10afc5e7e26baa",
  "urlList": [
      "https://www.example.com/url1",
      "https://www.example.com/folder/url2",
      "https://www.example.com/url3"
      ]
}
```

--------------------------------

### JSON batch submission with keyLocation variable

Source: https://www.indexnow.org/documentation

Use this HTTP request to submit a set of URLs when the key file is hosted at a custom location. The keyLocation variable in the JSON body specifies the key file path.

```HTTP
**POST** /indexnow **HTTP**/1.1
Content-Type: application/json; charset=utf-8
Host: <searchengine>
{
  "host": "www.example.com",
  "key": "3c78b3b7cf404670ab10afc5e7e26baa",
  "keyLocation": "https://www.example.com/myIndexNowKey63638.txt",
  "urlList": [
      "https://www.example.com/url1",
      "https://www.example.com/folder/url2",
      "https://www.example.com/url3"
      ]
}
```

--------------------------------

### Single URL submission with keyLocation parameter

Source: https://www.indexnow.org/documentation

Use this URL to submit a single URL when the key file is hosted at a custom location. The keyLocation parameter specifies the path to the key file.

```HTTP
https://<searchengine>/indexnow?url=http://www.example.com/product.html&key=3c78b3b7cf404670ab10afc5e7e26baa&keyLocation=http://www.example.com/myIndexNowKey63638.txt
```

--------------------------------

### POST /indexnow

Source: https://www.indexnow.org/documentation

Submits a set of URLs (up to 10,000) to a search engine using an HTTP POST request with a JSON body. A successful request returns HTTP 200.

```APIDOC
## POST /indexnow

### Description
Submits a set of URLs to a search engine to notify it of changes. The request is made via HTTP POST with a JSON body containing the host, key, and list of URLs.

### Method
POST

### Endpoint
/indexnow

### Parameters
#### Request Body
- **host** (string) - Required - The host name of your website (e.g., www.example.com).
- **key** (string) - Required - Your key. Must be 8 to 128 hexadecimal characters, containing only lowercase (a-z), uppercase (A-Z), numbers (0-9), and dashes (-).
- **urlList** (array of strings) - Required - List of URLs to submit. Up to 10,000 URLs per request, mixing http and https URLs if needed.

### Request Example
{
  "host": "www.example.com",
  "key": "3c78b3b7cf404670ab10afc5e7e26baa",
  "urlList": [
      "https://www.example.com/url1",
      "https://www.example.com/folder/url2",
      "https://www.example.com/url3"
  ]
}

### Response
#### Success Response (200)
- HTTP 200 indicates the search engine has received your set of URLs.

#### Response Example
HTTP 200
```

--------------------------------

### HTTP Response Codes

Source: https://www.indexnow.org/documentation

Lists the HTTP status codes returned by the IndexNow API when submitting URLs, including success, error, and rate-limiting responses.

```APIDOC
## HTTP Response Codes

### Description
This section documents the HTTP status codes returned by the IndexNow API when submitting URLs.

### Method
POST

### Endpoint
Not specified in source

### Response
#### Success Response (200)
- **HTTP Code**: 200 - OK
- **Response**: OK
- **Reasons**: URL submitted successfully

#### Success Response (202)
- **HTTP Code**: 202 - Accepted
- **Response**: Accepted
- **Reasons**: URL received. IndexNow key validation pending.

#### Error Response (400)
- **HTTP Code**: 400 - Bad request
- **Response**: Bad request
- **Reasons**: Invalid format

#### Error Response (403)
- **HTTP Code**: 403 - Forbidden
- **Response**: Forbidden
- **Reasons**: In case of key not valid (e.g. key not found, file found but key not in the file)

#### Error Response (422)
- **HTTP Code**: 422 - Unprocessable Entity
- **Response**: Unprocessable Entity
- **Reasons**: In case of URLs which don’t belong to the host or the key is not matching the schema in the protocol

#### Error Response (429)
- **HTTP Code**: 429 - Too Many Requests
- **Response**: Too Many Requests
- **Reasons**: Too Many Requests (potential Spam)
```
Tokens:
Raw