AEO Analytics

Get Bot Traffic

Returns the total number of requests tracked AI bots made to the site over a time range. Filter by bot provider or bot category. Counts successful requests (HTTP `200` or `304`) from the AI bots Webflow tracks. Bot providers combine with OR, and `botCategory` narrows them further. <Warning title="AEO analytics entitlement required">This endpoint requires a site or workspace with the AEO analytics entitlement.</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. Can’t be later than the start of the current UTC day, because today’s data isn’t available yet.

botProviderslist of enumsOptional

Count only bots from these providers. Repeat the parameter for more than one, such as botProviders=openai&botProviders=anthropic. Comma-separated values aren’t accepted.

botCategoryenumOptional
Count only bots in this category.
Allowed values:

Response

The total bot requests for the time range.
reportenum
The report type.
Allowed values:
windowobject
The time range of the report, echoed exactly as sent.
totalRequestCountinteger>=0

The number of successful requests (HTTP 200 or 304) that tracked AI bots made to the site’s pages and files.

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