Developer API

API Documentation

Integrate GetIndexedNow into your applications. Create indexer, checker, and reindexer tasks, check credits, monitor task status, and receive webhook notifications using your API key.

Get Your API Key

Overview

Core task management endpoints for the GetIndexedNow API

This API covers the core task management endpoints. Use it to create indexer, checker, and reindexer tasks, check your available credits, monitor task status by task ID, or receive real-time updates via webhooks when you configure a webhook URL on your API key.

Keep your API keys secure

Never share your API keys in public repositories or client-side code. Treat them like passwords. Generate keys from your account settings.

Authentication

All requests require a Bearer token

Include your API key in the Authorization header on every request. Keys use the format gti_live_....

Authorization: Bearer YOUR_API_KEY

Generate an API key from User Settings → API Keys.

Base URL

Production API endpoint

https://api.getindexednow.com

All endpoint paths below are relative to this base URL. Use Content-Type: application/json for POST requests.

Endpoints

Endpoints for checking credits, creating indexer, checker, and reindexer tasks, and monitoring task status.

GET

/api/user/tasks/credits

Get Task Credits

Returns the number of task credits remaining for the authenticated user. Check this before creating new tasks to ensure sufficient credits are available.

cURL Example

curl --location 'https://api.getindexednow.com/api/user/tasks/credits' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "credits": 150,
  "used": 50,
  "limit": 200
}

POST

/api/user/tasks

Create Indexer Task

Submit a new indexer task by providing a list of URLs, a title, and type "indexer". Uses the same POST /api/user/tasks endpoint as checker and reindexer tasks. The API returns a task ID which you can use to track progress.

Request Body

{
  "title": "My indexer task",
  "type": "indexer",
  "urls": ["https://example.com"]
}

cURL Example

curl --location 'https://api.getindexednow.com/api/user/tasks' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "title": "My indexer task",
    "type": "indexer",
    "urls": ["https://example.com"]
  }'

Example Response

{
  "task_id": "abc123-def456",
  "status": "pending",
  "message": "Task created successfully"
}

POST

/api/user/tasks

Create Checker Task

Submit a new checker task using the same endpoint as indexer tasks. Set type to "checker" to verify whether URLs are indexed by Google. The API returns a task ID which you can use to track progress and read per-URL indexing results.

Request Body

{
  "title": "My checker task",
  "type": "checker",
  "urls": ["https://example.com"]
}

cURL Example

curl --location 'https://api.getindexednow.com/api/user/tasks' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "title": "My checker task",
    "type": "checker",
    "urls": ["https://example.com"]
  }'

Example Response

{
  "task_id": "abc123-def456",
  "status": "pending",
  "message": "Task created successfully"
}

GET

/api/user/tasks/status/{task_id}

Get Task Status by Task ID

Returns the current status and per-URL results for indexer, checker, and reindexer tasks. Pass the task ID from your create-task response in place of {task_id} in the URL. Poll at regular intervals until status is completed. For checker tasks, each URL includes isIndexed and checkedAt. For indexer tasks, use each URL id in recreatedFromUrlIds when creating a reindexer task.

cURL Example

curl --location 'https://api.getindexednow.com/api/user/tasks/status/297703e3-6198-4951-8102-e0509dba84d8' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "taskId": "297703e3-6198-4951-8102-e0509dba84d8",
  "speedyTaskId": "6a28e7dfc19f717101e0ac55",
  "title": "checker new",
  "type": "google/checker",
  "status": "completed",
  "createdAt": "2026-06-10T04:28:07.365Z",
  "updatedAt": "2026-06-10T04:28:23.034Z",
  "urls": [
    {
      "id": "152a81c7-d575-43ba-99f6-1e1829af8079",
      "url": "https://contently.com",
      "isIndexed": false,
      "processingStatus": "completed",
      "title": "Not indexed by Google",
      "errorCode": null,
      "checkedAt": "2026-06-10T04:28:07.366Z"
    }
  ]
}

POST

/api/user/tasks

Create Reindexer Task

Re-submit URLs that failed to index. First call Get Task Status to retrieve the task results, then pick the id of each URL you want to reindex from the urls array and pass those values in recreatedFromUrlIds along with the matching URL strings.

Request Body

{
  "title": "Reindex failed URL",
  "type": "reindexer",
  "urls": ["https://contently.com"],
  "recreatedFromUrlIds": ["152a81c7-d575-43ba-99f6-1e1829af8079"]
}

cURL Example

curl --location 'https://api.getindexednow.com/api/user/tasks' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "title": "Reindex failed URL",
    "type": "reindexer",
    "urls": [
      "https://contently.com"
    ],
    "recreatedFromUrlIds": [
      "152a81c7-d575-43ba-99f6-1e1829af8079"
    ]
  }'

Example Response

{
  "task_id": "43fd9fc2-faff-4096-8ff4-d1f1df8a2867",
  "status": "pending",
  "message": "Task created successfully"
}

Typical Workflow

Recommended flow for creating tasks, checking status, and reindexing failed URLs

1
Check credits
Call GET /api/user/tasks/credits to confirm you have enough credits.
2
Create a task
Call POST /api/user/tasks with your URLs and title. Use type "indexer" to submit URLs for indexing, or type "checker" to verify Google indexing status. Note the task_id in the response.
3
Poll for status (or use webhooks)
Call GET /api/user/tasks/status/{task_id} until status is completed, or configure a webhookUrl on your API key to receive task status updates automatically. See the Webhooks section for setup and verification.
4
Collect URL IDs for reindexing
From the task status response, pick the id of each URL you want to reindex (e.g. where isIndexed is false). Use these values in recreatedFromUrlIds.
5
Create a reindexer task
Call POST /api/user/tasks with type "reindexer", the URL strings to reindex, and recreatedFromUrlIds set to the URL ids from the previous step.

Webhooks

Receive task status updates at your server instead of polling

When you create an API key, you can optionally set a webhookUrl. We POST JSON to that URL when task status changes. Generate keys from User Settings → API Keys.

What to copy from the API key create response

When you create an API key with a webhookUrl, the response includes:

key — Your API key. Always returned when a key is created.
webhookSecret — A 64-character hex string used to verify webhook requests. Only returned when you set a webhookUrl.

Copy webhookSecret immediately

The webhookSecret is shown only once at create (or when you rotate the secret). After that it is stored encrypted and is never returned again on list or other endpoints. If you create a key without a webhookUrl, there is no webhookSecret in the response.

Response with webhookUrl

{
  "key": "gti_live_xxxxxxxxxxxxxxxx",
  "webhookSecret": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"
}

Response without webhookUrl

{
  "key": "gti_live_xxxxxxxxxxxxxxxx"
}

How verification works

When a task status changes, we call the webhookUrl you entered when creating the API key:

When a task status changes, we send a POST request with a JSON body to the webhookUrl you provided when creating the API key.
We include your secret in the request header: X-Webhook-Secret.
Your server should read X-Webhook-Secret from the incoming request headers.
Compare the header value to the webhookSecret you saved when the key was created.
If the values match, the request is from GetIndexedNow — process the payload. If they do not match, or the header is missing, respond with 401 Unauthorized.

On your server (at the webhook URL)

Receive our POST request.
Read X-Webhook-Secret from the request headers.
Compare it to the webhookSecret you saved when the key was created.
Match → process the webhook payload. No match or missing header → reject with 401 Unauthorized.

Example verification handler

// Example handler (Node.js / Next.js Route Handler)
const WEBHOOK_SECRET = process.env.GETINDEXEDNOW_WEBHOOK_SECRET;

export async function POST(request: Request) {
  const receivedSecret = request.headers.get('X-Webhook-Secret');

  if (!receivedSecret || receivedSecret !== WEBHOOK_SECRET) {
    return new Response('Unauthorized', { status: 401 });
  }

  const payload = await request.json();
  // Process task status update from payload...

  return new Response('OK', { status: 200 });
}

Errors & Rate Limits

Handle API responses gracefully

401 Unauthorized — Invalid or missing API key. Verify your Bearer token.
403 Forbidden — Key lacks permission or account is restricted.
422 Unprocessable Entity — Invalid request body (e.g. malformed URLs).
429 Too Many Requests — Rate limit exceeded. Use exponential backoff when retrying.

Use exponential backoff for 429 responses, handle 401/403 gracefully, and log request IDs for error tracing when available.

curl --location 'https://api.getindexednow.com/api/user/tasks' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "title": "My indexer task", "type": "indexer", "urls": ["https://example.com"] }'

curl --location 'https://api.getindexednow.com/api/user/tasks' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "title": "My checker task", "type": "checker", "urls": ["https://example.com"] }'

curl --location 'https://api.getindexednow.com/api/user/tasks/status/297703e3-6198-4951-8102-e0509dba84d8' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY'

{ "taskId": "297703e3-6198-4951-8102-e0509dba84d8", "speedyTaskId": "6a28e7dfc19f717101e0ac55", "title": "checker new", "type": "google/checker", "status": "completed", "createdAt": "2026-06-10T04:28:07.365Z", "updatedAt": "2026-06-10T04:28:23.034Z", "urls": [ { "id": "152a81c7-d575-43ba-99f6-1e1829af8079", "url": "https://contently.com", "isIndexed": false, "processingStatus": "completed", "title": "Not indexed by Google", "errorCode": null, "checkedAt": "2026-06-10T04:28:07.366Z" } ] }

curl --location 'https://api.getindexednow.com/api/user/tasks' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --data '{ "title": "Reindex failed URL", "type": "reindexer", "urls": [ "https://contently.com" ], "recreatedFromUrlIds": [ "152a81c7-d575-43ba-99f6-1e1829af8079" ] }'

// Example handler (Node.js / Next.js Route Handler) const WEBHOOK_SECRET = process.env.GETINDEXEDNOW_WEBHOOK_SECRET; export async function POST(request: Request) { const receivedSecret = request.headers.get('X-Webhook-Secret'); if (!receivedSecret || receivedSecret !== WEBHOOK_SECRET) { return new Response('Unauthorized', { status: 401 }); } const payload = await request.json(); // Process task status update from payload... return new Response('OK', { status: 200 }); }

API Documentation

Overview

Keep your API keys secure

Authentication

Base URL

Endpoints

Get Task Credits

cURL Example

Example Response

Create Indexer Task

Request Body

cURL Example

Example Response

Create Checker Task

Request Body

cURL Example

Example Response

Get Task Status by Task ID

cURL Example

Example Response

Create Reindexer Task

Request Body

cURL Example

Example Response

Typical Workflow

Check credits

Create a task

Poll for status (or use webhooks)

Collect URL IDs for reindexing

Create a reindexer task

Webhooks

What to copy from the API key create response

Copy webhookSecret immediately

Response with webhookUrl

Response without webhookUrl

How verification works

On your server (at the webhook URL)

Example verification handler

Errors & Rate Limits

API Documentation

Overview

Keep your API keys secure

Authentication

Base URL

Endpoints

Get Task Credits

cURL Example

Example Response

Create Indexer Task

Request Body

cURL Example

Example Response

Create Checker Task

Request Body

cURL Example

Example Response

Get Task Status by Task ID

cURL Example

Example Response

Create Reindexer Task

Request Body

cURL Example

Example Response

Typical Workflow

Check credits

Create a task

Poll for status (or use webhooks)

Collect URL IDs for reindexing

Create a reindexer task

Webhooks

What to copy from the API key create response

Copy webhookSecret immediately

Response with webhookUrl

Response without webhookUrl

How verification works

On your server (at the webhook URL)

Example verification handler

Errors & Rate Limits