AEO Analytics

Get Visibility Score

Returns the share of answer engine responses that mention your organization, for a time range or as a daily or weekly series. Without `timeseries`, returns one score for the whole time range. With `timeseries`, returns one score per day or week. Separate filters combine with AND, and values within one filter combine with OR. Requires an organization name in the site's Organization info. <Warning title="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.</Warning> <Note title="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.</Note> 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"

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"

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.

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:
timeseriesobjectOptional

Return one score per day or week. Send both fields in bracket notation, such as timeseries[granularityPeriod]=day&timeseries[bucketTimeZone]=America/New_York.

Response

The visibility score for the time range.
reportenum
The report type.
Allowed values:
windowobject
The time range of the report, echoed exactly as sent.
brandNameslist of strings
Your organization name, then its aliases, from Organization info.
datalist of objects

One point for the whole time range, or one point per day or week when timeseries is sent, oldest first.

bucketingobjectOptional

The timeseries settings used. Present only when timeseries 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