Measures how a set of cohorts you specify relate to an audience: for each cohort, its overlap with the audience, its index — how much more or less likely a cohort member is to be in it than the average user — and how many net-new users it would add. Use this to get precise numbers on how cohorts are related to each other.
Example prompt
Which of my sports cohorts over-index against my luxury car intenders audience, and by how much?
Parameters
string
required
The audience to compare against, a LISP S-expression over cohort short ids.
string[]
required
The cohorts to compare the audience against — their short ids. min 1 item.
enum
How to trade estimate precision against how long the call takes. Omit for accuracy, which is the right choice here: this tool exists to produce figures you can report. one of: accuracy, balanced, speed.
RestrictTo object
Narrow the compared population to activity matching these dimensions.
Show RestrictTo
string[]
ISO 3166-1 alpha-3 country codes (e.g. GBR, USA). When set, only activity in these countries is counted. Use get_workspace_details to find which workspaces have user activities in which countries.
string[]
Domain names (e.g. example.co.uk). When set, only activity on these domains is counted. Use the workspace’s own domains, from get_workspace_details.
Window object
The date window to compare over.
Show Window
string (date)
End of the window (inclusive), ISO date e.g. 2026-06-30. Omit to default to today.
string (date)
Start of the window (inclusive), ISO date e.g. 2026-06-01. Omit to default to 30 days before end.
string[]
required
Workspaces whose user-behaviour data is compared across. min 1 item.
Returns
CohortReach object
required
The audience’s own reach over the window, with any restrict_to applied — the denominator behind every comparison’s overlap_percent and incremental_reach_percent.
Show CohortReach
integer (int64)
required
Estimated page views over the measurement window.
integer (int64)
required
Estimated unique users over the measurement window.
integer (int64)
required
Estimated video views over the measurement window.
AudienceComparison[]
One entry per comparison cohort available in the requested workspaces, in the order you supplied them.
Show AudienceComparison
string
required
The comparison cohort’s short id.
number (double)
required
Those net-new users as a percentage of the audience’s own size: incremental_reach_users / audience_reach.users × 100 — how much adding this cohort would grow the audience.
integer (int64)
required
Net-new users this cohort would add to the audience — users in the cohort but not already in it.
number (double)
required
How much more or less likely an audience member is to be in this cohort than the average user: 1.0 = average, 1.5 = 1.5× more likely, below 1.0 = under-represented.
number (double)
required
What percentage of the audience is also in this cohort: overlap_users / audience_reach.users × 100.
integer (int64)
required
Users the cohort shares with the audience.
integer (int64)
required
The cohort’s own size over the window.
string[]
Comparison cohorts (or cohorts referenced by the audience) not available in any of the requested workspaces.
Assistant
Responses are generated using AI and may contain mistakes.