Instant Indexing API

Overview

The Indexing API provides a high-throughput, programmatic way to request immediate crawling and indexing of your web pages. Unlike traditional sitemap submission, our API pushes URLs directly to Google's Indexing API, Bing's Webmaster Tools, and Yandex's catalog system simultaneously.

The API supports bulk submissions, priority tagging, and webhook callbacks for real-time indexing status updates. All requests are authenticated via API keys and rate-limited to ensure stability.

Authentication

All API requests require authentication using your secret API key. Include the key in the Authorization header using the Bearer scheme:

Authorization: Bearer sk_live_your_api_key_here

API keys can be generated from your dashboard under Settings → API Keys. Never expose secret keys in client-side code or public repositories. Use environment variables for secure storage.

Submit URL for Indexing

{
  "url": "https://example.com/blog/new-product-launch",
  "type": "product",
  "priority": "high",
  "notify_webhook": "https://your-app.com/webhooks/indexing"
}

{
  "success": true,
  "request_id": "idx_8f9a2b1c4d5e6f7g",
  "status": "queued",
  "estimated_crawl": "2-5 minutes",
  "message": "URL successfully submitted for indexing"
}

Check Indexing Status

{
  "request_id": "idx_8f9a2b1c4d5e6f7g",
  "url": "https://example.com/blog/new-product-launch",
  "status": "indexed",
  "submitted_at": "2025-01-15T10:30:00Z",
  "indexed_at": "2025-01-15T10:34:22Z",
  "engines": {
    "google": "indexed",
    "bing": "indexed",
    "yandex": "pending"
  }
}

Code Examples

import { SitemapClient } from '@sitemap/sdk';

const client = new SitemapClient({
  apiKey: process.env.SITEMAP_API_KEY
});

const result = await client.submitUrl({
  url: 'https://example.com/new-page',
  type: 'article',
  priority: 'high'
});

console.log(result.request_id);

import sitemap_api

client = sitemap_api.Client(api_key="sk_live_...")

result = client.submit_url(
    url="https://example.com/new-page",
    type="article",
    priority="high"
)

print(result["request_id"])

curl -X POST "https://api.sitemap.xml/v1/index" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/new-page",
    "type": "article",
    "priority": "high"
  }'

Rate Limits & Best Practices

To ensure API stability and fair usage, rate limits are enforced per API key. Exceeding limits will result in a 429 Too Many Requests response.

Error Codes