Get User Acquisition
GA4-style first-touch user acquisition: users attributed to the channel/source/medium/campaign of their first-ever session, with new-vs-returning classification (table) or new users per bucket (timeseries)
Authorizations
An API key created in your account settings, sent as Authorization: Bearer <key>.
Path Parameters
Site ID.
Query Parameters
Start of the range, as YYYY-MM-DD.
End of the range, as YYYY-MM-DD.
IANA time zone used to bucket the range, e.g. America/New_York.
"America/New_York"
JSON-encoded array of filter objects, each { dimension, op, value } where value is an array. Example: [{"dimension":"country","op":"equals","value":["US"]}]. A user-trait filter uses the templated dimension trait:<key> — [{"dimension":"trait:plan","op":"equals","value":["pro"]}] — and matches identified users only, by the trait's current value. Trait ops: equals, not_equals, contains, not_contains, starts_with, ends_with, is_null ("is not set"), is_not_null ("is set"); regex is not available. Trait filters require a member session or a users:read key, max 4 per query, and a filter matching more than 10,000 identified users fails with TRAIT_FILTER_TOO_BROAD.
channel, source, medium, campaign, source_medium, referrer table, timeseries all, identified, anonymous hour, day, week, month Example: 10.
previous_weekday, previous, year, custom Comparison Start Date. Example: YYYY-MM-DD (custom only).
Comparison End Date. Example: YYYY-MM-DD (custom only).
Response
Success.