List Audits

List published AEO audits with pagination and filtering.

GET/api/v1/audits

List published AEO audits with pagination. Returns deduplicated results enriched with sector and category data.

Query Parameters

Name	Type	Required	Description
`page`	number	Optional	Page numberDefault: `1`
`per_page`	number	Optional	Results per page (max 100)Default: `20`
`engine`	string	Optional	Filter by engine (e.g., "codex")

Code Example

bash

curl "https:">//www.aeocontent.ai/api/v1/audits?page=1&per_page=10" \
  -H "Authorization: Bearer $AEO_API_KEY"

Response

200Response 200 OK

json

{
  class="code-string">"data": [
    {
      class="code-string">"slug": class="code-string">"notion-com",
      class="code-string">"site": class="code-string">"notion.com",
      class="code-string">"engine": class="code-string">"chatgpt",
      class="code-string">"overall_score": 62,
      class="code-string">"verdict": class="code-string">"Moderate AEO readiness",
      class="code-string">"sector": class="code-string">"saas-productivity",
      class="code-string">"category": class="code-string">"Project Management",
      class="code-string">"created_at": class="code-string">"2026-02-15T10:30:00.000Z"
    }
  ],
  class="code-string">"meta": {
    class="code-string">"request_id": class="code-string">"...",
    class="code-string">"timestamp": class="code-string">"...",
    class="code-string">"page": 1,
    class="code-string">"per_page": 10,
    class="code-string">"total": 523
  }
}

Deduplication

Results are deduplicated by slug. If a domain has been audited multiple times, only the most recent audit is returned.

To retrieve all versions of an audit, use the GET /api/v1/audits/[slug] endpoint instead. The versions array in that response contains every historical version with its score and timestamp.