AI Overviews

GEThttps://api.boringmarketing.com/track/aio

Checks whether Google AI Overviews (AIO) appear for the hub keyword of each of your brand's topic families, and whether your brand's domain is cited within them. Capped at 10 keywords per call for cost control.

Query parameters

brand_idstringrequired

The brand UUID.

run_idstring

Pin to the families from a specific pipeline run. Defaults to the latest completed run.

Response

{
  "brand_id": "ea502f67-338b-47e4-a245-5c4eea8bd8d2",
  "pulled_at": "2026-04-07T10:00:00Z",
  "summary": "AIO present for 6/10 keywords. Cited in 2.",
  "results": [
    {
      "keyword": "ai marketing tools",
      "aio_present": true,
      "we_are_cited": false,
      "sources_cited": [
        "https://hubspot.com/...",
        "https://semrush.com/..."
      ],
      "aio_text_preview": "AI marketing tools help businesses automate campaigns..."
    },
    {
      "keyword": "marketing automation platforms",
      "aio_present": false,
      "we_are_cited": false
    }
  ]
}

If the brand has no topic families yet, the same envelope is returned with an empty results array and a message field:

{
  "brand_id": "ea502f67-338b-47e4-a245-5c4eea8bd8d2",
  "pulled_at": "2026-04-07T10:00:00Z",
  "message": "No topic families found. Run POST /brands/{id}/discover first to build the keyword universe.",
  "summary": "No topic families found.",
  "results": []
}

Field notes

Field	Description
`summary`	Human-readable one-line summary of AIO presence and citation count
`results[].aio_present`	Whether Google showed an AI Overview for this keyword's SERP
`results[].we_are_cited`	Whether your brand's domain appears in the AIO source list
`results[].sources_cited`	Up to 3 source URLs cited in the AIO (only included when `aio_present=true`)
`results[].aio_text_preview`	First 150 characters of the AIO generated text

Hub keywords are taken from the V2 families table (GET /brands/{id}/families), not the legacy cluster model.

Example

curl -H "X-API-Key: $BM_API_KEY" \
  "https://api.boringmarketing.com/track/aio?brand_id=$BRAND_ID"