Skip to main content
GET
Page traffic for humans and AI agents
See Page traffic: people and AI agents for how human and AI sources are counted and what the coverage limits are.

Authorizations

X-API-Key
string
header
required

API key in format: mk_live_{40 hex chars}

Query Parameters

since
string<date-time>

Inclusive start; default seven days before until

until
string<date-time>

Exclusive end; default now. Maximum window 31 days

domain
string

Exact hostname; does not widen to child or sibling sites

client_ref
string

Partner accounts only. Restrict results to one client by the reference label set on its tracked domains. Case-insensitive. If a client has several domains registered, all of them are included.

domain_group_id
string

Partner domain group ID. Matches exact member hostnames (www aliases normalized), including any member site the person has visited. Intersects domain, client_ref, and the key's scope; never grants extra access. Empty group returns zero matches; missing/foreign group returns 404; invalid ID returns 400. Keep this filter when following pagination cursors.

Pattern: ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$
path
string

Exact page path; no query or fragment

agent
string

Return only server AI traffic matching this returned agent ID

human_source
enum<string>
default:browser
Available options:
browser,
server
include_people
boolean
default:false

Match explicit browser identities to currently visible people; maximum 100 distinct emails per request

measure
enum<string>
default:all

human reads only human observations and omits ai fields; ai reads only server observations and omits human fields and identifiedPeople. Fields for the unrequested part are omitted, not zeroed

Available options:
all,
human,
ai
limit
integer
default:100
Required range: 1 <= x <= 1000
cursor
string

Reuse all filters; pins the time window. Batches requested within five minutes usually reuse the first batch's result; otherwise late arriving data can change results

Response

Per-page traffic and totals across all matching pages

data
object[]
required
totals
object
required
pagination
object
required
meta
object
required