API Reference

Business Impact Growth

Growth since the engagement started: before and now, weekly series and the work recorded each week.

GET/api/v1/reports/business-impact/growth

A view that does not depend on a window: the 28 days before the first article against the last 28 measured days, weekly series (full weeks only) and markers for the recorded work. Sources that count every visitor only.

Query Parameters

Name	Type	Required	Description
`domain`	string	Optional	The domain to report on (e.g., "example.com"). Required when the key can read more than one domain; GET /api/v1/domains lists them.

Example

bash

curl "https:">//studio.aeocontent.ai/api/v1/reports/business-impact/growth?domain=example.com" \
  -H "Authorization: Bearer $AEO_API_KEY"

Try it

Response

200Growth (abridged)

json

{
  class="code-string">"data": {
    class="code-string">"domain": class="code-string">"example.com",
    class="code-string">"engagement_start": class="code-string">"2026-04-01",
    class="code-string">"data_through": class="code-string">"2026-10-07",
    class="code-string">"baseline": {
      class="code-string">"from": class="code-string">"2026-03-04",
      class="code-string">"to": class="code-string">"2026-03-31"
    },
    class="code-string">"now_window": {
      class="code-string">"from": class="code-string">"2026-09-10",
      class="code-string">"to": class="code-string">"2026-10-07"
    },
    class="code-string">"before_now": [
      {
        class="code-string">"key": class="code-string">"search_clicks",
        class="code-string">"label": class="code-string">"Clicks from Google",
        class="code-string">"source": class="code-string">"Search Console",
        class="code-string">"before": 820,
        class="code-string">"now": 2034,
        class="code-string">"change_pct": 148,
        class="code-string">"measured_from": class="code-string">"2026-03-01",
        class="code-string">"unit": class="code-string">"count"
      }
    ],
    class="code-string">"series": [
      {
        class="code-string">"key": class="code-string">"search_clicks",
        class="code-string">"label": class="code-string">"Clicks from Google",
        class="code-string">"source": class="code-string">"Search Console",
        class="code-string">"measured_from": class="code-string">"2026-03-01",
        class="code-string">"unit": class="code-string">"count",
        class="code-string">"weeks": [
          {
            class="code-string">"week": class="code-string">"2026-09-28",
            class="code-string">"value": 512
          }
        ]
      }
    ],
    class="code-string">"markers": [
      {
        class="code-string">"week": class="code-string">"2026-09-28",
        class="code-string">"label": class="code-string">"Published: How AI engines choose which pages to cite",
        class="code-string">"count": 1
      }
    ],
    class="code-string">"note": class="code-string">"Before = the 28 days ending the day before the first article was published; Now = the last 28 measured days. A source that was not being measured before the start shows its first measured day instead of a comparison. Weekly charts show full Monday-to-Sunday weeks only. Organic search and AI engines only, counted for every visitor."
  },
  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-10-10T12:00:00.000Z"
  }
}

409Google Analytics not connected

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"not_connected",
    class="code-string">"message": class="code-string">"example.com has no Google Analytics property linked yet, so there is nothing to report. Ask your AEO Content contact to link it."
  }
}

403Domain below the Business plan

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"plan_required",
    class="code-string">"message": class="code-string">"API access is included with the Business plan, and example.com is not on the Business plan or higher. Upgrade on the Billing page in Studio."
  }
}

Sent with a Retry-After header: the seconds until the next request is allowed.

429Rate limit exceeded

json

{
  class="code-string">"error": {
    class="code-string">"code": class="code-string">"rate_limit_exceeded",
    class="code-string">"message": class="code-string">"Rate limit exceeded. Limits: 60 requests a minute, 2000 a day."
  }
}