Google Indexing API: Complete Guide (2026)

What Is the Google Indexing API?

The Google Indexing API is a programmatic interface that allows website owners to notify Google when pages are created, updated, or removed. Unlike sitemap submissions, the Indexing API sends direct signals to Googlebot, prompting near-immediate crawling of the specified URLs.

Introduced primarily for job listing websites and live streaming platforms, the API was designed to keep time-sensitive content fresh in Google's index. It operates through two actions: urlNotification.publish to submit URLs and urlNotification.get to check the status of a previously submitted URL.

Supported Content Types

Google strictly limits the Indexing API to two structured data types. Attempting to submit other URLs may work technically but will not be processed and could jeopardize your API credentials.

Prerequisites

Before you begin, ensure you have the following in place:

• A Google Cloud Platform (GCP) project with the Indexing API enabled
• A Service Account with the Search Console Owner permission for your verified property
• URLs must be crawlable (not blocked by robots.txt or noindex tags)
• Valid structured data (JobPosting or BroadcastEvent) on the target pages
• Python 3.7+ or Node.js environment for running API scripts

Setup Step by Step

Follow these steps to configure and authenticate the Indexing API for your project.

Code Example: Python

from google.oauth2 import service_account
from googleapiclient.discovery import build

SCOPES = ["https://www.googleapis.com/auth/indexing"]
KEY_FILE = "service-account.json"

credentials = service_account.Credentials.from_service_account_file(
    KEY_FILE, scopes=SCOPES
)
service = build("indexing", "v3", credentials=credentials)

# Notify Google about a new or updated URL
def publish_url(url: str):
    body = {
        "url": url,
        "type": "URL_UPDATED"
    }
    response = service.urlNotifications().publish(body=body).execute()
    print(f"Published: {response}")

# Notify Google to remove a URL
def delete_url(url: str):
    body = {
        "url": url,
        "type": "URL_DELETED"
    }
    response = service.urlNotifications().publish(body=body).execute()
    print(f"Deleted: {response}")

publish_url("https://example.com/jobs/software-engineer")

Limitations & Restrictions

Understanding the constraints of the Indexing API is critical to avoid wasted effort or policy violations.

• Content-type restriction: Only JobPosting and BroadcastEvent structured data pages are officially supported
• Daily quota: The default quota is 200 publish requests per day per project (can be increased via request)
• No guarantee of indexing: Submitting a URL does not guarantee it will be indexed — Google still evaluates content quality
• Authentication complexity: Requires a Service Account with Search Console ownership, which adds operational overhead
• Not a sitemap replacement: The API should complement, not replace, your sitemap strategy

Common Errors

When working with the Indexing API, developers frequently encounter these issues:

Alternatives with IndexLens

If your content does not fall under JobPosting or BroadcastEvent categories, the Indexing API cannot help you. IndexLens provides a comprehensive alternative for monitoring and improving your indexing status across all content types.