Getting Started

Set up your API key and run your first AEO audit in under 5 minutes.

Quick Start

Get your API key, submit a domain, and retrieve your first AEO audit in three steps.

Want to understand the scoring engine? AEORank is the deterministic engine behind every AEO Content AI audit. Review the methodology and criteria here: AEORank docs / Scoring system

Prerequisites

An AEO Content AI account with an active plan (Growth, Premium, or Business)
API key with read and write permissions

Don't have an account yet? Start with a free audit at aeocontent.ai to see your score before subscribing.

Step 1: Get Your API Key

Go to studio.aeocontent.ai and navigate to API Keys
Click Create API Key (requires SMS verification for security)
Your key will follow the format: aeo_live_ + 32 hex characters
Store the key securely - the full key is only shown once at creation

Never expose your API key in client-side code. Use environment variables and server-side requests only.

Step 2: Submit Your First Audit

Submit a domain for audit by sending a POST request. The API will queue the audit and return a slug you can use to check its status.

curl -X POST https://audit.aeocontent.ai/api/v1/audits \
  -H "Authorization: Bearer $AEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

Example response

response.json

{
  class="code-string">"data": {
    class="code-string">"slug": class="code-string">"example-com",
    class="code-string">"domain": class="code-string">"example.com",
    class="code-string">"status": class="code-string">"pending",
    class="code-string">"message": class="code-string">"Audit queued"
  },
  class="code-string">"meta": {
    class="code-string">"request_id": class="code-string">"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    class="code-string">"timestamp": class="code-string">"2026-02-22T12:00:00.000Z"
  }
}

Step 3: Poll for Results

Audits take a few minutes to complete. Poll the status endpoint until the audit reaches completed.

bash

curl https:"code-comment">//audit.aeocontent.ai/api/v1/audits/example-com/status \
  -H "Authorization: Bearer $AEO_API_KEY"

Status progression

pendingAudit is queued and waiting to be picked up

discoveringIdentifying competitors and classifying your domain

auditingAI engines are evaluating your site across 53 criteria

seedingProcessing and storing the audit results

visibilityTesting your domain against real AI engine queries

completedAudit is ready to retrieve

Step 4: Get Your Audit

Once the status reaches completed, retrieve the full audit report with scores, findings, and recommendations.

bash

curl https:"code-comment">//audit.aeocontent.ai/api/v1/audits/example-com \
  -H "Authorization: Bearer $AEO_API_KEY"

Add ?include=fix_prompts to the request to receive actionable remediation advice alongside each finding - ready to pass directly to an AI coding agent.

Next Steps

Authentication

Rate limits, permissions, and API key management

Scoring System

Understand the 53 criteria and how your score is calculated

Agent Fix Loop

Automate improvements with an AI agent workflow

MCP Tools

Integrate with Claude Code, Cursor, and other AI agents

AEORank Engine

Understand the deterministic engine behind every AEO audit