---
title: "Get Top Pages"
method: GET
path: "/analytics/behavior/pages"
tags: ["Web Analytics"]
---

# Get Top Pages

`GET /analytics/behavior/pages`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/analytics/behavior/pages`
- Auth: HTTP bearer

Get top pages by views and unique visitors.

## Query parameters

- `limit` integer: Number of pages to return
- `write_key` string, nullable: Comma-separated public keys to filter by
- `include_bots` boolean: Count bot and crawler traffic too. Off by default: page views from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded. Set true for the raw, unfiltered counts these reports returned before the filter existed.
- `include_internal` boolean: Count internal traffic too. Off by default: page views on the graph8 app (app.graph8.com) and local development hosts, and browsers identified as your own team members (member emails and your company email domains), are excluded.
- `days` integer: Number of days to analyze
- `date_from` string, nullable: Anchored window start (YYYY-MM-DD). Must be sent with date_to.
- `date_to` string, nullable: Anchored window end (YYYY-MM-DD). Must be sent with date_from.
- `start_date` string, nullable: Alias of date_from (YYYY-MM-DD), the name the other analytics reports use. Sent alone, the window runs from start_date to today (UTC).
- `end_date` string, nullable: Alias of date_to (YYYY-MM-DD). Sent alone, the window is the `days` days ending on end_date.

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Response `200`

Successful Response

- AnalyticsResponse: Standard analytics response wrapper.
  - `success` boolean
  - `data` union, required
    - object
    - unknown[]
      - unknown
  - `meta` AnalyticsMeta, required: Metadata for analytics responses.
    - `org_id` string, required
    - `days` integer, required
    - `cached` boolean, required
    - `stale` boolean
    - `cache_ttl` integer
    - `timestamp` string, date-time, required
    - `query_time_ms` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)