API Reference

List Audits

List published AEO audits with pagination and filtering.

GET/api/v1/audits

List published AEO audits with pagination. Returns 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., "chatgpt")

Example

bash

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

Try it

Response

200Paginated list

json

{
  class="code-string">"data": [
    {
      class="code-string">"slug": class="code-string">"notion-com",
      class="code-string">"domain": class="code-string">"notion.com",
      class="code-string">"engine": class="code-string">"chatgpt",
      class="code-string">"overall_score": 62,
      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">"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    class="code-string">"timestamp": class="code-string">"2026-02-22T12:00:00.000Z",
    class="code-string">"page": 1,
    class="code-string">"per_page": 20,
    class="code-string">"total": 523
  }
}

If a domain has multiple engines, each engine appears as a separate row. To retrieve all versions of a single domain audit, use GET /api/v1/audits/[slug].