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"

Response

On success, the API queues a new audit and returns the previous score for reference. Use GET /audits/[slug]/status to poll until the re-audit reaches completed.

200Re-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. Use GET /audits/example-com/status to poll 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"
  }
}

Already Running

If an audit is already in progress for this domain, the API returns 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. Use aeo_get_audit_status to poll progress."
  },
  class="code-string">"meta": {
    class="code-string">"request_id": class="code-string">"b2c3d4e5-f6a7-8901-bcde-f12345678901",
    class="code-string">"timestamp": class="code-string">"2026-02-22T12:01:00.000Z"
  }
}

Errors

The domain must have an existing published audit. Attempting to re-audit an unknown slug returns a 404.

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'. Run an audit first."
  }
}

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

Version Tracking

When a re-audit completes with a different score, a new version is automatically created. Use the Get Audit endpoint to see all versions and track score progression over time.

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 the previous score for reference. Use GET /audits/[slug]/status to poll until the re-audit reaches completed.

200Re-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. Use GET /audits/example-com/status to poll 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"
  }
}

Already Running

If an audit is already in progress for this domain, the API returns 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. Use aeo_get_audit_status to poll progress."
  },
  class="code-string">"meta": {
    class="code-string">"request_id": class="code-string">"b2c3d4e5-f6a7-8901-bcde-f12345678901",
    class="code-string">"timestamp": class="code-string">"2026-02-22T12:01:00.000Z"
  }
}

Errors

The domain must have an existing published audit. Attempting to re-audit an unknown slug returns a 404.

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'. Run an audit first."
  }
}

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

Version Tracking

When a re-audit completes with a different score, a new version is automatically created. Use the Get Audit endpoint to see all versions and track score progression over time.

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.