Tool name search_cohorts
Searches for cohorts matching a natural language query across one or more workspaces.
Example prompt
Find cohorts of high-income readers interested in luxury cars and premium lifestyle content.
Parameters
Maximum number of cohorts to return. Defaults to 20.
Only include cohorts with at most this many users. Omit for no upper bound.
Only include cohorts with at least this many users. Omit for no lower bound.
The keywords, persona or campaign description to match.
Workspaces to search across. min 1 item.
Returns
Cohorts matching the query, ranked by relevance (most relevant first).
Which of the requested workspaces this cohort can be used from. Pass any of these to follow-up tools. min 1 item.
Cohort type one of: custom, lookalike, contextual, standard, classificationModel, advertiser.
Human-readable cohort name.
Workspace where this cohort was originally defined.
Stable unique cohort identifier (UUID).
Short cohort identifier. Pass to get_cohort_detail, and as the cohort reference in measure_audiences expressions.
A summary of how users are targeted in this cohort. May be absent for newly created cohorts.
Estimated unique users in the last 30 days, across the requested workspaces.
