Tool name measure_audiencesMeasures the reach of an audience by combining multiple cohorts — how many users are in it and how many page views they generate.
Example prompt
How many users and page views would I reach if I combined the luxury car cohort with the premium travel cohort, broken down by country?
Parameters One or more audience expressions to measure, each a string in LISP S-expression form. min 1 item.
Which breakdowns to include beyond total reach. each one of: cohort_contributions, domain_breakdown, device_breakdown, country_breakdown, workspace_breakdown, engagement, time_series_daily, time_series_weekly.
Narrow the measured population to activity matching these dimensions. 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.
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.
The date window to measure over. End of the window (inclusive), ISO date e.g. 2026-06-30. Omit to default to today.
Start of the window (inclusive), ISO date e.g. 2026-06-01. Omit to default to 30 days before end.
Workspaces whose user-behaviour data is aggregated across. min 1 item.
Returns One measurement per measurable expression. Per-cohort contribution to this expression. Cohort’s standalone size within the restrict_to filters.
Cohort’s incremental contribution of unique users to the composed expression.
Users per country (ISO 3166-1 alpha-3 code) within this expression’s audience. Show CountryBreakdownEntry
ISO 3166-1 alpha-3 country code (e.g. GBR, USA).
Estimated page views in this country.
Estimated unique users in this country.
Users per device type within this expression’s audience. Show DeviceBreakdownEntry
Device type (e.g. Desktop, Mobile, Tablet, CTV).
Estimated page views on this device type.
Estimated unique users on this device type.
Users per publisher domain within this expression’s audience. Show DomainBreakdownEntry
Estimated page views on this domain.
Estimated unique users on this domain.
How engaged this expression’s audience is, beyond its size. Total engaged time across the audience, in seconds.
Average engaged time per user, in seconds.
Average page views per user.
The expression that was evaluated, echoed back so results can be paired with inputs.
Daily time-series: one bucket per calendar day in the window, users and page views for each. The time bucket: an ISO date (e.g. 2026-06-01) for a daily series, an ISO week-of-year number (e.g. 22) for a weekly series.
Estimated page views in this bucket.
Estimated unique users in this bucket.
Weekly time-series: one bucket per ISO week in the window, users and page views for each. The time bucket: an ISO date (e.g. 2026-06-01) for a daily series, an ISO week-of-year number (e.g. 22) for a weekly series.
Estimated page views in this bucket.
Estimated unique users in this bucket.
total_reach CohortReach object
required
Total reach for this expression across the requested workspaces, within the restrict_to filters. Estimated page views over the measurement window.
Estimated unique users over the measurement window.
Estimated video views over the measurement window.
workspace_breakdown WorkspaceBreakdownEntry[]
Users per requested workspace within this expression’s audience. Show WorkspaceBreakdownEntry
Estimated unique users in this workspace matching the expression.
One of the requested workspace IDs.
Expressions that were not measured because one or more of their cohorts aren’t available in any of the requested workspaces. Show ExpressionUnavailable
The expression that could not be measured, echoed back so it can be paired with your input.
The cohort short ids in this expression that aren’t available in any of the requested workspaces. min 1 item.
