Get Bot Traffic by Page | Webflow Developer Documentation

curl -G https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/aeo/reports/bot_traffic_pages \
     -H "Authorization: Bearer <token>" \
     --data-urlencode startTime=2026-09-01T00:00:00Z \
     --data-urlencode endTime=2026-09-08T00:00:00Z \
     -d botProviders=openai \
     -d limit=10

{
  "report": "bot_traffic_pages",
  "window": {
    "startTime": "2026-09-01T00:00:00Z",
    "endTime": "2026-09-08T00:00:00Z"
  },
  "data": [
    {
      "requestCount": 420,
      "page": {
        "pageId": "68cdb4b5a699862fcd8c1a31",
        "title": "Home"
      }
    },
    {
      "requestCount": 42,
      "page": {
        "pageId": "68cdb4b5a699862fcd8c1a30",
        "collectionId": "68cdb4b5a699862fcd8c1a40",
        "itemSlug": "dont-panic",
        "title": "Don't Panic"
      }
    },
    {
      "requestCount": 7,
      "page": {
        "title": "/sitemap.xml"
      }
    }
  ]
}

Returns the pages and files that the AI bots Webflow tracks requested most over a time range, with each one’s request count.

Results are sorted by requestCount, highest first, and aren’t paginated. Each row is one combination of page, CMS item, and request path, so a page can appear more than once.

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:

limitintegerOptional1-100Defaults to 100

Maximum number of rows to return. Defaults to 100, which is also the maximum.

Response

The pages and files bots requested most.

reportenum

The report type.

Allowed values:

windowobject

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

datalist of objects

The pages and files bots requested most, sorted by requestCount, highest first.

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