Meta Ads / API Reference
meta_ads_find_location
Meta Ads tool. Look up a real place -- city, neighbourhood, postcode, region -- and get the exact Meta geo key needed to target it. THIS IS THE ONLY WAY TO TARGET A SPECIFIC PLACE. `geo_locations` will not accept a place name: a city, neighbourhood or postcode has to be given as an opaque key like '2420379' that only this lookup can produce. Guessing a key, or falling back to `{"countries":["IL"]}` because the key was unknown, quietly targets an entire country -- the ad still runs, and it runs on the wrong people while spending real money. Call this before meta_ads_create_adset or meta_ads_update_adset_targeting whenever the user names anywhere smaller than a country, then pass the returned `geo_locations` straight through (or combine several with meta_ads_build_geo_targeting). For a point on the map with no name -- a shop, a venue, a catchment around an address -- skip this and use meta_ads_build_geo_targeting's `custom_pins` with the latitude and longitude instead. Args: q: The place to find, e.g. 'Tel Aviv', 'Ramat Gan', '90210' (required). Search Meta's own names: it indexes English and local spellings, so try the other spelling before concluding a place is unavailable. location_types: Comma-separated filter, any of: country, region, city, subcity, neighborhood, subneighborhood, zip, geo_market, electoral_district, place. Blank searches all types, which is usually what you want first -- narrow only if the results are cluttered. country_code: Two-letter code to restrict the search, e.g. 'IL'. Use it when a name is ambiguous across countries (there are many Springfields). radius_km: Optional radius, 16-80 km, applied to the ready-made `geo_locations` in each result. Only meaningful for cities, places, neighbourhoods and postcodes. 16 km (10 miles) is Meta's floor around a named place -- anything smaller is accepted and reaches nobody. For a tighter circle use custom_pins in meta_ads_build_geo_targeting. Blank means Meta's own boundary for the place, the right default for a city. limit: Maximum matches to return. Default 15.
This is a read-only tool: it finds location from your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Find location in my Meta Ads account for [q].
It takes 1 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Q |
location_types | string | No | Location Types |
country_code | string | No | Country Code |
radius_km | string | No | Radius Km |
limit | integer | No | Limit |
Related Meta Ads tools
meta_ads_find_accountmeta_ads_find_pagemeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limit
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account:
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.