Skip to main content
The API is currently in beta. Endpoints and behavior are subject to change.
The Hado SEO API lets you programmatically invalidate cached pages so search engines always see your latest content, and export your crawl analytics as JSON. When you purge a page, Hado SEO immediately re-renders it and stores fresh HTML in the cache — no waiting for the next bot visit.

​
Base URL

All API requests are made to:

​
Available Endpoints

Purge Cache

Re-render a specific page and refresh its cached HTML

Export Analytics

Export granular per-bot analytics for all your domains as JSON

Export Crawl Analytics

Export verified/declared crawl totals per bot, with intent taxonomy

Export Page Analytics

Export page-level crawl counts — which pages bots hit, with tier splits

Export Page Snapshots

Export which rendered HTML version each bot was served for a page, day by day

Get Snapshot

Fetch the exact HTML a bot was served, by snapshot ID

Export AI Referrals

Export human visits arriving from AI answer surfaces (ChatGPT, Perplexity, …)

Bot Definitions

The published bot taxonomy — every intent bucket and the bots in it, versioned

​
Quick Start

1

Create an API Key

Go to Settings → API Keys in your Hado SEO dashboard and create a new key. Copy it immediately — it’s only shown once.
2

Purge a page

3

Verify

The response confirms the re-render job is queued. Fresh HTML will be available in cache within seconds.

​
Common Use Cases

​
Rate Limits

All API calls are subject to per-minute and monthly rate limits based on your plan. See Authentication for details.