x_ads_search_targeting_locations

Search targetable locations by name. One of 26 X Ads tools on the Get MCP Ads MCP gateway.

Search targetable locations by name. Use this to find the targeting_value IDs required by add_targeting_criterion for LOCATION-type criteria. Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Source: X Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: account_id
Endpoint: https://mcp.getmcpads.com/x-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`count`	integer	Optional	Number of records to return per page (1-1000).
`country_code`	string	Optional	Two-letter ISO country code to scope results to, e.g. US.
`cursor`	string	Optional	Pagination cursor from a previous response.
`location_type`	string	Optional	Scope results to one location granularity. One of: `COUNTRIES`, `REGIONS`, `METROS`, `CITIES`, `POSTAL_CODES`.
`q`	string	Optional	Free-text location name to search for, e.g. "united states" or "london". Omit to list locations u...

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_search_targeting_locations",
    "args": {}
  }
}