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, and is capped at 200.
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, curated.
When the cohort was created (ISO-8601). Absent for cohort types that don’t record a creation time (e.g. standard cohorts).
Human-readable cohort name.
Workspace where this cohort was originally defined.
Short cohort identifier. Pass to get_cohort_detail, and as the cohort reference in measure_audiences expressions.
Whether the cohort is enabled or disabled.
What the cohort targets: a user, a group of users (ie. a household), or a piece of content. one of: user, user_group, content.
A summary of how users are targeted in this cohort. May be absent for newly created cohorts.
Tags applied to the cohort. Empty when the cohort has none.
Estimated unique users in the last 30 days, across the requested workspaces.
