Skip to main content
GET
Get crawl-to-visit correlation

Authorizations

Authorization
string
header
required

A Searchable API key, created under Settings → Workspace → Integrations. Send as Authorization: Bearer sea_xxxxx. Every key carries one or more scopes (read, write, admin) and may optionally be bound to a single project — see Getting started.

Path Parameters

projectId
string<uuid>
required

The project id.

Query Parameters

days
integer

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

Required range: x >= 1
from
string

Start of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires to, and is mutually exclusive with days — sending both returns 400 invalid_argument. A range longer than the endpoint's maximum is rejected rather than clamped.

Example:

"2026-03-01"

to
string

End of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires from.

Example:

"2026-03-31"

host
string

Comma-separated hostnames to narrow the report to. Useful on multi-domain projects; omit for every host in the project.

Example:

"blog.acme.com"

limit
integer

Page size. Defaults and caps vary by endpoint (see each operation's description); big list endpoints (cited domains/URLs, prompts, opportunities) cap at 1000, issues at 5000. Values above an endpoint's cap are clamped server-side, never rejected.

Required range: x >= 1

Response

Per-page crawl and AI-referral correlation rows.

Per page, crawls and AI-referred sessions over the SAME window, joined by path. Co-occurrence, not attribution.

pages
object[]
required
pagesConsidered
number
required

Size of the ranked population — a floor on the true page count, not a site-wide total.

populationTruncated
boolean
required

True when the upstream per-set cap (500) was reached, so pages are certainly missing.

dateRange
object
required