API Reference

Toolbar Sync

Sync a locally-run audit from the AEORank Chrome extension to Supabase.

POST/api/v1/toolbar/sync

Receives a locally-run audit from the AEORank Chrome extension and syncs it to Supabase. Creates or updates the published audit and version history.

Example

bash

curl -X POST "https:">//audit.aeocontent.ai/api/v1/toolbar/sync" \
  -H "Authorization: Bearer $AEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "slug": "example-com",
    "audit": {
      "overallScore": 72,
      "verdict": "Good AEO readiness with room for improvement.",
      "scorecard": [{"id":1,"criterion":"llms.txt","score":0,"status":"fail"}],
      "detailedFindings": [],
      "opportunities": [],
      "pitchNumbers": [],
      "bottomLine": "Example site needs AI-specific signals."
    }
  }'

Try it

Response

The audit data has been saved. scoreChanged indicates whether a new version was created.

200Sync successful

json

{
  class="code-string">"ok": true,
  class="code-string">"version": 3,
  class="code-string">"scoreChanged": true
}

400Missing fields

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"bad_request",
    class="code-string">"message": class="code-string">"domain, slug, and audit are required."
  }
}

401Unauthorized

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"unauthorized",
    class="code-string">"message": class="code-string">"Valid API key or auth token required to sync."
  }
}

Requires either an API key (Authorization: Bearer) or a portal JWT token (X-Auth-Token header). Anonymous installs cannot sync.