Discovers cohorts you have not specified whose users correlate with a seed audience — the cohorts most worth considering as an extension of it, each with its overlap and index (affinity). A discovery tool, not a reporting one.
Restrict the suggestions to these cohort types. Omit to suggest all types the caller can see except lookalikes. min 1 item. each one of: custom, lookalike, contextual, standard, classificationModel, advertiser, curated.
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.
Pass as page_token to fetch the next page of suggestions. Absent on the last page. Valid for about 15 minutes from the first page, so other tool calls in between are fine.
A page of up to 50 suggested cohorts to extend the seed audience, ordered by index descending (strongest affinity first). Near-duplicates of the seed (overlap at or above max_overlap) are excluded, so a high-index cohort that merely re-surfaces the seed doesn’t crowd out genuine extensions.
How reliable this suggestion’s index and overlap are — they’re estimated from sampled sketches, not exact counts, and the estimate is noisiest when the overlap with the seed is small. Treat high as trustworthy; on medium and low, weigh that the true value may differ substantially, and re-measure with compare_audience before reporting a figure. All three levels are returned by default; set include_low_confidence to false to drop low. one of: high, medium, low.
Those net-new users as a percentage of the seed’s own size: incremental_reach_users / seed_reach.users × 100 — how much adding this cohort would grow the seed audience.
Present only when no cohort in the library was a usable extension of the seed — the seed overlaps too little to extend from. Returned on the first page only.
