Public API · Webhooks · Agent-ready

The AI-visibility data layer for developers and platforms.

AEO Spotlight's monitoring engine is a consumable API. Verdict-aware citations, 4-tier visibility gaps, competitor snapshots, and the content lifecycle as clean JSON, async by design, with one credit ledger.

Ground truth they can act on: verified, explainable, and permissioned.

Quickstart

Wire AI visibility into anything in minutes.

1

Generate a scoped API key

From Dashboard → Developer → API Keys. Keys are hash-stored, shown once, and instantly revocable, with read, read_write, and publish scopes.

2

Make your first call

curl https://api.aeospotlight.com/api/v1/me \
  -H "X-API-Key: aeo_live_YOUR_KEY"
3

Listen for events

Every paid operation returns 202 + a jobId. Poll it, or get an HMAC-signed webhook the moment it finishes.

What you can build

Every capability, async and idempotent.

Verdict-aware data

Every citation returns a DetectionVerdict with confidence and evidence: GroundedCitation, ExactCleanMatch, AmbiguousOnly, or NotDetected.

Async by design

Query runs, gap detection, and content generation return 202 + a job id. Idempotent retries, charge-on-success, per-provider partial results.

Webhooks (push)

HMAC-SHA256-signed events: mention.detected, gap.detected, content.published, content.cited, credit signals, and more. No polling loops.

Scoped keys & budgets

Per-key rate limits and daily credit ceilings, one shared credit ledger, instant revoke. A misbehaving agent can't drain your balance.

Agent Control

Let an agent run the loop with your permission.

ProposeThe agent spots a gap, generates content, and proposes publishing.
ApproveOne-click approve in the dashboard, or let high-trust agents auto-publish.
VerifyEvery action is audited with the exact prompt and the cited result.

Autonomy tiers: L0 manualL1 auto-proposeL2 auto-publish (earned: 20+ approvals at 95%+).

Reference

Self-documenting from day one.

TypeScript & Python SDKs and an MCP server are on the roadmap.

Stop being invisible to AI in your own product.