Skip to content

meta_search_targeting

Find Meta detailed targeting IDs for targeting.flexible_spec: interests by name (mode interests, Graph search type=adinterest), interests, behaviours…

View as Markdown

Find Meta detailed targeting IDs for targeting.flexible_spec: interests by name (mode interests, Graph search type=adinterest), interests, behaviours and demographics by name (mode detailed, the ad account targeting search), every option of one category (mode browse: behaviors, demographics, life_events, industries, income, family_statuses, interests), suggestions next to known interests (mode suggestions), or whether interest IDs still exist (mode validate). Each row gives id, name, targetingField (the flexible_spec key it goes under), path, audience size bounds and description. Use only IDs returned here; Meta retires options over time. Read-only.

Source
Meta Ads
Kind
Read
Discovery
Reachable through search_tools and run_tool
Account parameter
adAccountId
Endpoint
https://mcp.getmcpads.com/meta-ads/mcp

Parameters

Parameters
NameTypeRequiredNotes
adAccountIdstringRequiredOwning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
modestringRequiredinterests and detailed search queries; browse lists a category; suggestions and validate take interests. One of: interests, detailed, browse, suggestions, validate.
queriesarrayOptionalinterests and detailed: names to search (running shoes, frequent travelers, parents), one search each.
categorystringOptionalbrowse only: the targeting category to list. One of: behaviors, demographics, life_events, industries, income, family_statuses, interests.
interestsarrayOptionalsuggestions: interest names; validate: interest IDs (digits) or names.
localestringOptionalLanguage of the names returned, as fr_FR or en_US.
limitintegerOptionalRows per search, 25 by default.

Calling it

json · Through run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "meta_search_targeting",
    "args": {
      "adAccountId": "<string>",
      "mode": "interests"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.

Esc

Type to search