10 / API

Bring your prompts. Get back the full AEO stack. JSON.

Your agent generates better prompts for your client than our generic vertical-detect ever could. Send them; we probe ChatGPT + Gemini + AI Overview, layer in Citation Readiness from our exclusive Ollagraph backend, citation gap, crawlability audit, and probe-evidenced recommendations — all in one bundled JSON response. Identical prompts hit our cross-tenant cache → $0 marginal cost on repeat.

Get your API key → Read the docs 
# 1. Onboard a domain + send the prompts your AI agent generated.
#    Identical prompts across agencies hit our cross-tenant cache for
#    $0 marginal LLM cost — the canonical cache-friendly flow.
#    Auto-everything also works: just omit custom_prompts.
curl -X POST https://api.aeoniti.com/v1/domains \
     -H "Authorization: Bearer aeo_..." \
     -d '{
       "domain": "acme.com",
       "custom_prompts": [
         "best CRM for indian startups in 2026",
         "Acme vs HubSpot for mid-market SaaS",
         "top CRM tools with built-in email automation"
       ]
     }'
# -> 202 { domain_id: 171, status_url: "/v1/reports/171", eta_seconds: 75 }

# 2. Pull the full bundled report ~75s later
curl -H "Authorization: Bearer aeo_..." \
     https://api.aeoniti.com/v1/reports/171
# -> 200 { overview, citation_readiness, signals, citation_gap,
#         crawlability, prompt_runs, recommendations }

Sign up at login.aeoniti.com, mint a key at /agency/api-keys, ship. Dashboard at login.aeoniti.com is read-only — see your tiles, the API does the configuration.

What's in the bundled response

Each /v1/reports/{id} response packs the entire AEO intelligence stack into one JSON. No second call to fetch signals separately. No third call for citation gap. One read, everything.

Citation Readiness Page-level AEO grade from our exclusive Ollagraph backend — 12 typed signals per top-10 buyer-intent URL.
Probe Results Brand mentions + citations across ChatGPT (gpt-5.4-nano), Gemini (3.5 Flash), AI Overview. Per-prompt sentiment.
Citation Gap Bidirectional metric: Attribution Loss (URL cited but brand not named) vs Click Loss (brand named, URL not cited).
Crawlability Audit robots.txt, llms.txt, JSON-LD schema, AI-bot block policy, per-industry baseline from our CC web graph.
Recommendations Probe-evidenced action items. Every rec carries the AI-answer quote that proved the gap.
Competitor Landscape Top brands cited in the same AI answers. Discovered, not configured — the AI tells us who your real competitors are.
Free
$0/mo

Kick the tires. No card.

  • ✓ 1 fresh report / mo
  • ✓ 100 cached reads / mo
  • ✓ 30 req / min
  • ✓ Sync & async endpoints
  • ✓ 3 engines: ChatGPT, Gemini, AI Overview
Get started free
Starter
$39/mo

For solo agencies + indie tools. $351/yr — 25% off billed yearly.

  • ✓ 5 fresh reports / mo
  • ✓ 2,000 cached reads / mo
  • ✓ 60 req / min
  • ✓ Webhook delivery (HMAC signed)
  • ✓ Email support
Start with Free, upgrade later
Agency
$149/mo

For multi-client agencies. $1,341/yr — 25% off billed yearly.

  • ✓ 50 fresh reports / mo
  • ✓ 20,000 cached reads / mo
  • ✓ 300 req / min
  • ✓ White-label report URLs (v1.1)
  • ✓ Priority support
Start with Free, upgrade later

Async webhooks (Standard Webhooks v1)

POST /v1/reports/{id}/refresh returns a job ID immediately. When the scan completes, we POST the report to your callback URL with Standard Webhooks v1 HMAC headers (webhook-id, webhook-timestamp, webhook-signature) — the same spec Vercel and Cloudflare use. 300-second timestamp tolerance. Verify with the standardwebhooks library in any language. 

POST /v1/reports/171/refresh HTTP/1.1
Authorization: Bearer aeo_...
-> 202 { "job_id": "job_8a91...", "eta_seconds": 75 }

# ~75s later, your callback receives:
POST https://your.app/webhooks/aeoniti HTTP/1.1
webhook-id:        msg_3F2H...
webhook-timestamp: 1735689600
webhook-signature: v1,QFh7Ag/Q4mE... v1,8sLk2x...
Content-Type:      application/json

{ "domain_id": 171, "report": { ... full bundled stack ... } }

/v1/diligence — brand health bundle

One endpoint for VC and M&A diligence reports. Citation share, hallucination count, AI bot policy, Citation Readiness — all in one payload, sized for a slide deck.

MethodPathReturns
GET /v1/diligence/brand/{domain} brand-AEO health bundle

Designed for fund analysts running diligence on a 50-name pipeline. One key, fifty domains, fifty bundled brand health snapshots — citation share across ChatGPT + Gemini + AI Overview, hallucination + contradiction count, AI bot policy vs industry baseline, Citation Readiness grade.

Why an API on top of the dashboard?

The dashboard tells you what's happening. The API lets your tools know — automation, reporting, white-label client dashboards. Same data, same auth, same agency. Upgrade the API tier from your dashboard and every key in your agency lifts instantly.