Getting Started

Quick Start

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

Prerequisites

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

Step 1: Get Your API Key

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

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://www.aeocontent.ai/api/v1/audits \
  -H "Authorization: Bearer $AEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

Example response

{
  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.

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

Status progression

Step 4: Get Your Audit

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

curl https:"code-comment">//www.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