Search Cohorts - Permutive

Tool name search_cohorts

Read-only · Idempotent

Searches for cohorts matching a natural language across one or more workspaces. Can be keywords (“automotive, luxury, UK”), a campaign brief (“high-income readers interested in luxury cars and premium lifestyle content”), or a question. Results are ranked by semantic relevance to this query.

Example prompt

Find cohorts of high-income readers interested in luxury cars and premium lifestyle content.

Parameters

limit

integer (int32)

Maximum number of cohorts to return. Defaults to 20.

query

string

required

The keywords, persona or campaign description to match.

workspace_ids

string[]

required

Workspaces to search across. min 1 item.

Returns

cohorts

CohortSearchResult[]

Cohorts matching the query, ranked by relevance (most relevant first).

Show CohortSearchResult

available_in_workspaces

string[]

required

Which of the requested workspaces this cohort can be used from. Pass any of these to follow-up tools. min 1 item.

name

string

required

Human-readable cohort name.

owning_workspace

string (uuid)

required

Workspace where this cohort was originally defined.

public_id

string (uuid)

required

Stable unique cohort identifier (UUID).

short_id

string

required

Short cohort identifier.

summary

string

A summary of how users are targeted in this cohort. May be absent for newly created cohorts.

Measure Audiences

⌘I

​Example prompt

​Parameters

​Returns

Example prompt

Parameters

Returns