Skip to navigation
AEO Analytics

Get Bot Traffic

Returns the total number of requests made to the site by the AI bots Webflow tracks, over a time range. This counts bot requests, not visitors or page views. For visitor traffic, use the Analyze API. Filter by bot provider or bot category.

Counts successful requests (HTTP 200 or 304). Bot providers combine with OR, and botCategory narrows them further.

AEO analytics entitlement required
This endpoint requires a site or workspace with the AEO analytics entitlement.
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. 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 the AI bots Webflow tracks 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