API Documentation

Push URLs to Google's Indexing API via a per-website webhook.

Webhook endpoint

Each website you connect gets a unique webhook URL.

POST https://YOUR-DOMAIN/api/public/webhook/{token}
Content-Type: application/json

Request body

{
  "url": "https://example.com/blog/post-1",
  "type": "URL_UPDATED"
}
  • url — full URL to (re)index. Must belong to the website's domain.
  • typeURL_UPDATED or URL_DELETED. Defaults to URL_UPDATED.

Response

{
  "ok": true,
  "status": 200,
  "body": { "urlNotificationMetadata": { ... } }
}

Error codes

StatusMeaning
400Missing or invalid url/type
401Unknown webhook token
403Website is not verified
412No service account uploaded
500Upstream/Google error — see response body

Example: cURL

curl -X POST https://YOUR-DOMAIN/api/public/webhook/{token} \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page","type":"URL_UPDATED"}'