Get Top Pages Report | Webflow Developer Documentation

curl -G https://api.webflow.com/beta/sites/580e63e98c9a982ac9b8b741/analyze/reports/top_pages \
     -H "Authorization: Bearer <token>" \
     --data-urlencode startTime=2026-04-01T00:00:00Z \
     --data-urlencode endTime=2026-04-08T00:00:00Z \
     -d sortBy=session \
     -d limit=25 \
     -d includeTimeseries=true \
     -d deviceType=desktop \
     -d country=US \
     --data-urlencode pagePath=/towels \
     -d trafficSource=SO \
     -d referrer=google.com \
     -d browser=Chrome \
     -d utmCampaign=dont-panic-2026 \
     -d utmMedium=email \
     -d utmSource=hitchhikers-guide

{
  "report": "top_pages",
  "window": {
    "startTime": "2026-04-01T00:00:00Z",
    "endTime": "2026-04-08T00:00:00Z"
  },
  "sortBy": "session",
  "limit": 25,
  "data": [
    {
      "pageId": "65f1b2c4a8d3e5f7a9c1b2d3",
      "title": "Don't Panic — Towels & Travel Gear",
      "sessionCount": 4242,
      "userCount": 3900,
      "pageviewCount": 5400,
      "timeseries": [
        {
          "timestamp": "2026-04-01T00:00:00Z",
          "pageviewCount": 720
        },
        {
          "timestamp": "2026-04-02T00:00:00Z",
          "pageviewCount": 810
        },
        {
          "timestamp": "2026-04-03T00:00:00Z",
          "pageviewCount": 690
        },
        {
          "timestamp": "2026-04-04T00:00:00Z",
          "pageviewCount": 750
        },
        {
          "timestamp": "2026-04-05T00:00:00Z",
          "pageviewCount": 820
        },
        {
          "timestamp": "2026-04-06T00:00:00Z",
          "pageviewCount": 780
        },
        {
          "timestamp": "2026-04-07T00:00:00Z",
          "pageviewCount": 830
        }
      ]
    },
    {
      "pageId": "65f1b2c4a8d3e5f7a9c1b2d4",
      "title": "So Long, and Thanks for All the Fish",
      "sessionCount": 1800,
      "userCount": 1700,
      "pageviewCount": 2300,
      "collectionId": "6494a077f0050acad8774bd1",
      "itemSlug": "so-long-and-thanks-for-all-the-fish",
      "timeseries": [
        {
          "timestamp": "2026-04-01T00:00:00Z",
          "pageviewCount": 280
        },
        {
          "timestamp": "2026-04-02T00:00:00Z",
          "pageviewCount": 350
        },
        {
          "timestamp": "2026-04-03T00:00:00Z",
          "pageviewCount": 310
        },
        {
          "timestamp": "2026-04-04T00:00:00Z",
          "pageviewCount": 320
        },
        {
          "timestamp": "2026-04-05T00:00:00Z",
          "pageviewCount": 340
        },
        {
          "timestamp": "2026-04-06T00:00:00Z",
          "pageviewCount": 360
        },
        {
          "timestamp": "2026-04-07T00:00:00Z",
          "pageviewCount": 340
        }
      ]
    }
  ],
  "filter": {
    "browser": {
      "eq": "Chrome"
    },
    "country": {
      "eq": "US"
    },
    "deviceType": {
      "eq": "desktop"
    },
    "pagePath": {
      "eq": "/towels"
    },
    "referrer": {
      "eq": "google.com"
    },
    "trafficSource": {
      "eq": "SO"
    },
    "utmCampaign": {
      "eq": "dont-panic-2026"
    },
    "utmMedium": {
      "eq": "email"
    },
    "utmSource": {
      "eq": "hitchhikers-guide"
    }
  }
}

Returns the most-visited pages over a time window, ranked by sortBy (sessions, users, or pageviews).

Each row carries all three scope counts; sortBy only governs ordering. Filter the report with top-level query parameters (country, deviceType, pagePath, etc.) or via the filter parameter for multi-value and negation matching.

Set includeTimeseries=true to attach a daily pageview timeseries to each row. Bucket counts are always pageviews regardless of sortBy — row-level counts honor the requested sort; the timeseries does not.

Analyze add-on required

This endpoint requires a workspace with the Analyze add-on.

Concurrency limit: 1 request at a time

Each access token can have one Analyze request in flight at a time, across all Analyze 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

Returns the most-visited pages over a time window, ranked by `sortBy` (sessions, users, or pageviews). Each row carries all three scope counts; `sortBy` only governs ordering. Filter the report with top-level query parameters (`country`, `deviceType`, `pagePath`, etc.) or via the `filter` parameter for multi-value and negation matching. Set `includeTimeseries=true` to attach a daily pageview `timeseries` to each row. Bucket counts are always pageviews regardless of `sortBy` — row-level counts honor the requested sort; the timeseries does not. <Warning title="Analyze add-on required">This endpoint requires a workspace with the Analyze add-on.</Warning> <Note title="Concurrency limit: 1 request at a time">Each access token can have one Analyze request in flight at a time, across all Analyze 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"

Inclusive start of the reporting window. Must be a UTC timestamp in ISO 8601 / RFC 3339 format ending in Z (for example, 2026-04-01T00:00:00Z); numeric offsets such as -04:00 or +00:00 are not accepted. Must be on or after 2025-04-09T00:00:00Z.

endTimestringRequiredformat: "date-time"

Exclusive end of the reporting window. Must be a UTC timestamp in ISO 8601 / RFC 3339 format ending in Z (for example, 2026-04-08T00:00:00Z); numeric offsets such as -04:00 or +00:00 are not accepted. Must be greater than startTime and within 100 days of it.

sortByenumOptionalDefaults to session

Metric used to rank rows in the response, descending. Defaults to session.

Allowed values:

limitintegerOptional1-250Defaults to 25

Maximum number of rows to return. Defaults to 25, up to a maximum of 250.

includeTimeseriesbooleanOptionalDefaults to false

When true, each row is augmented with a daily pageview timeseries covering the requested window. Defaults to false. See TopPagesTimeseriesPoint for bucket shape and scope.

deviceTypeenumOptional

Restrict the report to a single device type.

Allowed values:

countrystringOptional=2 characters

Restrict the report to a single country. ISO 3166-1 alpha-2 (two letters, normalized to uppercase).

pagePathstringOptional

Restrict the report to a single page path.

trafficSourcestringOptional

Restrict the report to a single traffic source code (for example, SO for Organic Search).

referrerstringOptional

Restrict the report to a single referrer domain.

browserstringOptional

Restrict the report to a single browser.

utmCampaignstringOptional

Restrict the report to a single utm_campaign value.

utmMediumstringOptional

Restrict the report to a single utm_medium value.

utmSourcestringOptional

Restrict the report to a single utm_source value.

filterobjectOptional

Filter the report by dimension. Use bracket notation. Scalars take a single value (filter[country][eq]=US, filter[country][ne]=US). Arrays use indexed brackets (filter[country][in][0]=US&filter[country][in][1]=CA, filter[country][nin][0]=US&filter[country][nin][1]=CA). Each dimension entry takes at least one of eq, in, ne, or nin. Filter a given dimension in one place — either a top-level query parameter or a filter entry. See the TopPagesFilter schema for the full list of supported dimensions.

Filter the report by dimension. Use bracket notation. Scalars take a single value (`filter[country][eq]=US`, `filter[country][ne]=US`). Arrays use indexed brackets (`filter[country][in][0]=US&filter[country][in][1]=CA`, `filter[country][nin][0]=US&filter[country][nin][1]=CA`). Each dimension entry takes at least one of `eq`, `in`, `ne`, or `nin`. Filter a given dimension in one place — either a top-level query parameter or a `filter` entry. See the `TopPagesFilter` schema for the full list of supported dimensions.

Response

Pages ranked by sortBy for the requested window and filters.

reportenum

Discriminator identifying the report type.

windowobject

A reporting time window. endTime must be greater than startTime.

sortByenum

The metric used to rank rows in the response, descending. Row-level sessionCount, userCount, and pageviewCount are always all returned regardless of sortBy.

session: rank by session count (default).
user: rank by unique user count.
pageview: rank by pageview count.

limitinteger1-250

The row cap that was applied to this response (echoes the resolved request value, including the default).

datalist of objects

Pages ranked by sortBy, descending. At most limit rows.

filterobject

Filter the top pages report by dimension. Each property is an optional set of AnalyzeFilterOperators (eq, in, ne, nin) applied to the named dimension. Filter a given dimension in one place — either inside filter or as a top-level query parameter.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

Returns the most-visited pages over a time window, ranked by sortBy (sessions, users, or pageviews).

Analyze add-on required

This endpoint requires a workspace with the Analyze add-on.

Concurrency limit: 1 request at a time

Required scope | sites:read