Skip to main content
Tool name compare_audience
Read-only · Idempotent
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.
Window object
The date window to compare over.
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.
AudienceComparison[]
One entry per comparison cohort available in the requested workspaces, in the order you supplied them.
string[]
Comparison cohorts (or cohorts referenced by the audience) not available in any of the requested workspaces.