SEsearchable
Traffic

Get traffic attribution

Changed on

Traffic attribution by UTM tuple (source / medium / campaign) plus referrer domain and bot category, ranked by request count. limit defaults to 50, max 200.

get/api/mcp/projects/{projectId}/traffic/attribution

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

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

fromstring
Example:2026-03-01

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.

tostring
Example:2026-03-31

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

hoststring
Example:blog.acme.com

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

limitinteger

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.

Response

Attribution rows ranked by request count.

totalRowsnumber required
truncatedboolean required

True when the source aggregate's 100-row cap was hit — totalRows is then a floor.

Changes