API Reference

6 read endpoints for the domains a key can read and their Business Impact reports: search clicks, AI answer arrivals, leads and calls to action, per page, per event and since the start. Included with the Business plan.

Base URL

All endpoints are prefixed with this base URL.

bash

https:"code-comment">//studio.aeocontent.ai/api/v1

The complete reference, response shapes included, is also served as plain markdown for coding agents, with no key needed: https://studio.aeocontent.ai/api/v1/reports/business-impact/docs

Authentication

All requests require a Bearer token in the Authorization header.

bash

Authorization: Bearer aeo_live_...

See Authentication for details on creating keys, permissions, and rate limits.

Response Format

All successful responses return a data object and a meta object with a unique request ID and timestamp.

Success response

json

{
  class="code-string">"data": { ... },
  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"
  }
}

Report endpoints that take format=csv return CSV instead of JSON.

Error responses return an error object with a machine-readable code and a human-readable message.

Error response

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"error_code",
    class="code-string">"message": class="code-string">"Human-readable message"
  }
}

Error Codes

Code	Status	Description
`bad_request`	400	Invalid parameters, such as a domain that is not a hostname, or no domain when the key can read several
`unauthorized`	401	Missing, invalid, revoked or expired API key
`forbidden`	403	The key cannot read this domain (its account is not a member), or lacks the permission for this endpoint
`plan_required`	403	A member domain that is not on the Business plan or higher, which API access needs
`not_connected`	409	The domain has no Google Analytics property linked yet
`rate_limit_exceeded`	429	Per key rate limit exceeded: wait the seconds the Retry-After header gives
`internal_error`	500	Unexpected server error. Contact support if it persists

Endpoints

Method	Path	Description	Permission
GET	`/domains`	Domains this key can read	`read`
GET	`/reports/business-impact`	Full traffic and leads report	`read`
GET	`/reports/business-impact/summary`	The period in plain English	`read`
GET	`/reports/business-impact/pages`	One row per landing page	`read`
GET	`/reports/business-impact/events`	One row per lead or CTA event	`read`
GET	`/reports/business-impact/growth`	Growth since the start	`read`