Opus Growth

Meta Interest Search

Searches Meta detailed-targeting entities by name → returns id + estimated audience size.

Type
Reads only
Credits
1
Platform
Meta Ads
Approval
Not needed, nothing changes

What it does

Searches Meta detailed-targeting entities by name → returns id + estimated audience size. kind: adinterest (interest) | adworkemployer (employer) | adeducationschool (school) | adgeolocation (location) | adTargetingCategory (DEMOGRAPHICS & BEHAVIOURS catalogue). adTargetingCategory also requires category_class: "family_statuses" (parents, child age brackets), "life_events" (newly-wed, recently moved, birthday soon...), "industries" (job sector), "behaviors", "income"; an empty query lists the whole class. The returned ids feed create_meta_adset / update_meta_adset (family_statuses, life_events, industries, behaviors). Relationship status and education level are NOT in this catalogue: they are fixed numeric codes passed directly as relationship_statuses / education_statuses. Location ids come back in `key`, not `id`.

MCP: search_meta_interests

How to use it

You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.

Parameters

NameTypeRequiredDefault
querystringRequired·Search or report query used to filter or select results.
kindstringOptionaladinterestObject kind to read or change, using one of the kinds supported by this operation.
limitintegerOptional20Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete.
category_classstringOptional·Exact category class value for search meta interests. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation.