API Reference

Re-audit

Queue a fresh audit for a previously audited domain to measure score changes after improvements.

POST/api/v1/audits/[slug]/reaudit

Queue a fresh audit for a previously audited domain. Use after making improvements to measure score changes.

Path Parameters

Name	Type	Required	Description
`slug`	string	Required	Domain slug of a previously audited site

Example

bash

curl -X POST "https:">//www.aeocontent.ai/api/v1/audits/example-com/reaudit" \
  -H "Authorization: Bearer $AEO_API_KEY"

Try it

Response

On success the API queues a new audit and returns 201 Created. Use GET /audits/[slug]/status to poll until the re-audit reaches completed.

201Re-audit queued

json

{
  class="code-string">"data": {
    class="code-string">"slug": class="code-string">"example-com",
    class="code-string">"status": class="code-string">"queued",
    class="code-string">"previous_score": 62,
    class="code-string">"message": class="code-string">"Re-audit queued. Poll GET /api/v1/audits/example-com/status for progress."
  },
  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"
  }
}

If an audit is already running for this domain, returns 200 with the current status instead of queuing a duplicate.

200Audit already in progress

json

{
  class="code-string">"data": {
    class="code-string">"slug": class="code-string">"example-com",
    class="code-string">"status": class="code-string">"auditing",
    class="code-string">"previous_score": 62,
    class="code-string">"message": class="code-string">"An audit is already auditing. Poll GET /api/v1/audits/example-com/status for progress."
  },
  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"
  }
}

404No existing audit

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"not_found",
    class="code-string">"message": class="code-string">"No published audit found for slug 'unknown-com'."
  }
}

Only one audit can run per domain at a time. Wait for the current audit to complete before requesting another re-audit.

Re-audits that produce the same score as the previous version update the existing version in place rather than creating a new one. This prevents version bloat from retries.

Name

Type

Required

Description

slug

string

Required

Domain slug of a previously audited site

Example

bash

curl -X POST "https:">//www.aeocontent.ai/api/v1/audits/example-com/reaudit" \
  -H "Authorization: Bearer $AEO_API_KEY"

Response

On success the API queues a new audit and returns 201 Created. Use GET /audits/[slug]/status to poll until the re-audit reaches completed.

201Re-audit queued

json

{
  class="code-string">"data": {
    class="code-string">"slug": class="code-string">"example-com",
    class="code-string">"status": class="code-string">"queued",
    class="code-string">"previous_score": 62,
    class="code-string">"message": class="code-string">"Re-audit queued. Poll GET /api/v1/audits/example-com/status for progress."
  },
  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"
  }
}

If an audit is already running for this domain, returns 200 with the current status instead of queuing a duplicate.

200Audit already in progress

json

{
  class="code-string">"data": {
    class="code-string">"slug": class="code-string">"example-com",
    class="code-string">"status": class="code-string">"auditing",
    class="code-string">"previous_score": 62,
    class="code-string">"message": class="code-string">"An audit is already auditing. Poll GET /api/v1/audits/example-com/status for progress."
  },
  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"
  }
}

404No existing audit

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"not_found",
    class="code-string">"message": class="code-string">"No published audit found for slug 'unknown-com'."
  }
}