Skip to main content
GET
List the most visited pages

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.

Path Parameters

projectId
string
required
Minimum string length: 1
Pattern: ^[A-Za-z0-9_-]{1,100}$
Example:

"b1f2c3d4-0000-4000-8000-000000000000"

Query Parameters

days
integer

Rolling window size in days. Ignored when from is set. Defaults to 30 days.

Required range: 1 <= x <= 365
from
string

First UTC day to include (YYYY-MM-DD). Replaces days. Without to, the window runs through today.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-01-31"

to
string

Last UTC day to include (YYYY-MM-DD). Also applies without from: it cuts off the days window, which still counts back from today. Omit to include today.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-01-31"

limit
integer

Maximum rows to return. Defaults to 20.

Required range: 1 <= x <= 500
visitorType
enum<string>
Available options:
crawler,
ai_referral
host
string

Hostname to filter on. Subdomains of this host are included. Omit for every host.

Maximum string length: 128

Response

Pages fetched successfully

configured
boolean
required

False when the traffic backend is not configured for this deployment; the payload is then empty rather than an error.

pages
object[]
required

One row per host, path, source and visitor type, most requests first.

organization
object
required