Get Visibility Score Breakdown | Webflow Developer Documentation

curl -G https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/aeo/reports/visibility_breakdown \
     -H "Authorization: Bearer <token>" \
     --data-urlencode startTime=2026-09-01T00:00:00Z \
     --data-urlencode endTime=2026-09-08T00:00:00Z \
     -d breakdown=topic \
     -d limit=10 \
     -d topicIds=68cdb4b5a699862fcd8c1a02 \
     -d promptIds=68cdb4b5a699862fcd8c1a01

{
  "report": "visibility_breakdown",
  "window": {
    "startTime": "2026-09-01T00:00:00Z",
    "endTime": "2026-09-08T00:00:00Z"
  },
  "breakdown": "topic",
  "brandNames": [
    "Hitchhiker's Guide",
    "The Guide"
  ],
  "data": [
    {
      "visibilityScore": 0.9,
      "topic": {
        "id": "68cdb4b5a699862fcd8c1a03",
        "name": "Towels"
      }
    },
    {
      "visibilityScore": 0.42,
      "topic": {
        "id": "68cdb4b5a699862fcd8c1a02",
        "name": "Galactic travel"
      }
    }
  ]
}

Returns the visibility score for each topic or prompt over a time range, highest first.

Choose breakdown=topic or breakdown=prompt. A topic or prompt appears only if it has responses in the time range. Separate filters combine with AND, and values within one filter combine with OR. Requires an organization name in the site’s Organization info.

AEO analytics entitlement required

This endpoint requires a site or workspace with the AEO analytics entitlement, and Webflow AI must be enabled for the workspace.

Concurrency limit: 1 request at a time

Each access token can have one AEO request in flight at a time, across all AEO Analytics endpoints. Additional concurrent requests return 429 Too Many Requests. Wait for your in-flight request to finish, or for the Retry-After interval, then retry.

Required scope | sites:read

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

Query parameters

startTimestringRequiredformat: "date-time"

Inclusive start of the time range. Must be a UTC timestamp ending in Z, such as 2026-09-01T00:00:00Z. Offsets and date-only values aren’t accepted. Seconds and milliseconds are optional.

endTimestringRequiredformat: "date-time"

Exclusive end of the time range. Must be a UTC timestamp ending in Z, and later than startTime. The range can be at most 100 days.

breakdownenumRequired

Return one row per topic or per prompt.

Allowed values:

limitintegerOptional1-100

Maximum number of rows to return, up to 100. Omit it to return every row.

topicIdslist of stringsOptional

Include only these topics. Get topic IDs from List Prompts. Repeat the parameter for more than one, up to 50.

promptIdslist of stringsOptional

Include only these prompts. Get prompt IDs from List Prompts. Repeat the parameter for more than one, up to 50.

answerEngineenumOptional

Include only responses from this answer engine.

Allowed values:

Response

The visibility score for each topic or prompt.

reportenum

The report type.

Allowed values:

windowobject

The time range of the report, echoed exactly as sent.

breakdownenum

Whether each row is a topic or a prompt.

Allowed values:

brandNameslist of strings

Your organization name, then its aliases, from Organization info.

datalist of objects

The topics or prompts, sorted by visibilityScore, highest first.

limitintegerOptional1-100

The limit sent. Present only when limit was sent.

filterobjectOptional

The filters the report used. Present only when a filter was sent.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error