Search Geo

Search for OpenAI Ads location IDs (geo targets) by name — countries, regions, and DMAs

Search for OpenAI Ads location IDs (geo targets) by name — countries, regions, and DMAs. Use the returned location ids as location_ids in openai_ads_create_campaign targeting.

App	OpenAI Ads
Operation ID	openai_ads_search_geo
Type	Action
Connection	openai_ads (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
search_terms	string	Yes	-	Location names to search for, separated by commas or newlines (e.g. ‘California, New York, United States’). Returns location IDs to use in campaign targeting (openai_ads_create_campaign location_ids).
limit	integer	No	50	Maximum number of locations to return. Default: 50.

Output

Type: List[Dict]

Returns matching locations with id, type, name, canonical_name, country_code, region_code, parent_country, parent_id, and the search_term that matched.

Fields: dynamic (depend on the inputs)

Example:

[
  {
    "id": "2000043",
    "type": "region",
    "name": "California",
    "canonical_name": "California, United States",
    "country_code": "US",
    "region_code": "US-CA",
    "search_term": "california"
  }
]