API Reference - Hado SEO

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:

https://api.hadoseo.com/functions/v1

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 AI Referrals

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

Quick Start

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.

Purge a page

curl -X POST https://api.hadoseo.com/functions/v1/purge-cache \
  -H "Authorization: Bearer hado_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourapp.com",
    "path": "/about"
  }'

Verify

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

Common Use Cases

Use Case	When to Purge
CMS content update	After publishing or editing a blog post
Product page change	After updating pricing, images, or descriptions
Landing page deploy	After pushing changes to your app

Rate Limits

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

​Base URL

​Available Endpoints

Purge Cache

Export Analytics

Export Crawl Analytics

Export Page Analytics

Export AI Referrals

​Quick Start

​Common Use Cases

​Rate Limits

Base URL

Available Endpoints

Quick Start

Common Use Cases

Rate Limits