Public API

citeai.io HTTP API

Free, no signup. Rate-limited per IP. Use it to integrate the GEO audit into your own tools or CI pipelines.

Audit a URL

Returns the full AuditResult JSON: GEO score, bot matrix, six checks, and prioritized fixes.

GET

curl 'https://citeai.io/api/audit?url=https://example.com'

POST (recommended)

curl -X POST https://citeai.io/api/audit \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com"}'

Limits

GET /api/audit: 10 req/hour
POST /api/audit: 30 req/hour

Cache

Repeated requests for the same domain within 5 minutes return a cached result (cached: true). Pass ?force=1 to bypass.

Citation test

Asks Claude (with web search enabled) a question and reports whether your domain appears among the cited sources.

POST

curl -X POST https://citeai.io/api/citation \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com", "query": "best framework for AI search"}'

Limit

POST /api/citation: 5 req/hour

Status

Tier 2 feature; 402 when not enabled on a deployment.

Response headers

X-RateLimit-Limit — your hourly cap
X-RateLimit-Remaining — calls left in the current window
X-RateLimit-Reset — seconds until the window rolls over

Errors

Status	Meaning
400	Invalid input (URL, JSON, etc.)
402	Tier 2 disabled on this deployment
429	Rate limit exceeded
500	Audit failed on our side
502	Upstream API failed (citation only)

No auth, ever?

Free tier is anonymous. If you need higher limits, batch processing, or alerts, that's the Tier 2/3 product roadmap.