search_geo_locations
Search and retrieve geographic targeting locations for Meta Ads campaigns using a query and optional filters like location type or limit. Returns JSON with location details for precise ad targeting.
Instructions
Search for geographic targeting locations.
Args:
access_token: Meta API access token (optional - will use cached token if not provided)
query: Search term for locations (e.g., "New York", "California", "Japan")
location_types: Types of locations to search. Options: ['country', 'region', 'city', 'zip',
'geo_market', 'electoral_district']. If not specified, searches all types.
limit: Maximum number of results to return (default: 25)
Returns:
JSON string containing location data with key, name, type, and geographic hierarchy information
Input Schema
Name | Required | Description | Default |
---|---|---|---|
access_token | No | ||
limit | No | ||
location_types | No | ||
query | No |
Input Schema (JSON Schema)
{
"properties": {
"access_token": {
"default": null,
"title": "Access Token",
"type": "string"
},
"limit": {
"default": 25,
"title": "Limit",
"type": "integer"
},
"location_types": {
"default": null,
"items": {
"type": "string"
},
"title": "Location Types",
"type": "array"
},
"query": {
"default": null,
"title": "Query",
"type": "string"
}
},
"title": "search_geo_locationsArguments",
"type": "object"
}