IndexNow API Tutorial — Submit URLs to Search Engines Instantly

Create a random API key (minimum 8 characters, maximum 128 characters). You can use any combination of letters and numbers.

Tip: Use a UUID generator or random string generator for security.

Create a text file named [your-api-key].txt containing only your API key. Upload it to the root of your website.

Ensure the file is publicly accessible (returns 200 status code when visited).

Test your setup by submitting a single URL using cURL:

curl -X POST "https://api.indexnow.org/indexnow" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "example.com",
    "key": "your-api-key-here",
    "keyLocation": "https://example.com/your-api-key.txt",
    "urlList": [
      "https://example.com/page1",
      "https://example.com/page2"
    ]
  }'

A 200 response code indicates success. 400/403 indicates an error with your API key or URL format.

import requests
import json

def submit_to_indexnow(urls, api_key, domain):
    """
    Submit URLs to IndexNow API

    Args:
        urls: List of URLs to submit
        api_key: Your IndexNow API key
        domain: Your domain (e.g., 'example.com')
    """
    endpoint = "https://api.indexnow.org/indexnow"

    payload = {
        "host": domain,
        "key": api_key,
        "keyLocation": f"https://{domain}/{api_key}.txt",
        "urlList": urls
    }

    response = requests.post(
        endpoint,
        headers={"Content-Type": "application/json"},
        data=json.dumps(payload)
    )

    if response.status_code == 200:
        print(f"✓ Successfully submitted {len(urls)} URLs")
        return True
    else:
        print(f"✗ Error: {response.status_code}")
        return False

# Usage example
urls = [
    "https://example.com/blog/post-1",
    "https://example.com/blog/post-2",
    "https://example.com/products/new-product"
]

api_key = "your-api-key-here"
domain = "example.com"

submit_to_indexnow(urls, api_key, domain)

const axios = require('axios');

async function submitToIndexNow(urls, apiKey, domain) {
  const endpoint = 'https://api.indexnow.org/indexnow';

  const payload = {
    host: domain,
    key: apiKey,
    keyLocation: `https://${domain}/${apiKey}.txt`,
    urlList: urls
  };

  try {
    const response = await axios.post(endpoint, payload, {
      headers: { 'Content-Type': 'application/json' }
    });

    if (response.status === 200) {
      console.log(`✓ Successfully submitted ${urls.length} URLs`);
      return true;
    }
  } catch (error) {
    console.error('✗ Error:', error.response?.status || error.message);
    return false;
  }
}

// Usage example
const urls = [
  'https://example.com/blog/post-1',
  'https://example.com/blog/post-2',
  'https://example.com/products/new-product'
];

const apiKey = 'your-api-key-here';
const domain = 'example.com';

submitToIndexNow(urls, apiKey, domain);

<?php
function submitToIndexNow($urls, $apiKey, $domain) {
    $endpoint = 'https://api.indexnow.org/indexnow';

    $payload = [
        'host' => $domain,
        'key' => $apiKey,
        'keyLocation' => "https://$domain/$apiKey.txt",
        'urlList' => $urls
    ];

    $options = [
        'http' => [
            'method' => 'POST',
            'header' => 'Content-Type: application/json',
            'content' => json_encode($payload)
        ]
    ];

    $context = stream_context_create($options);
    $response = file_get_contents($endpoint, false, $context);

    if ($response !== false) {
        echo "✓ Successfully submitted " . count($urls) . " URLs\n";
        return true;
    } else {
        echo "✗ Error submitting URLs\n";
        return false;
    }
}

// Usage example
$urls = [
    'https://example.com/blog/post-1',
    'https://example.com/blog/post-2',
    'https://example.com/products/new-product'
];

$apiKey = 'your-api-key-here';
$domain = 'example.com';

submitToIndexNow($urls, $apiKey, $domain);
?>