Search Locations

Search Microsoft Ads geographical location IDs for campaign targeting

Search Microsoft Ads geographical location IDs for campaign targeting.

App	Microsoft Ads
Operation ID	microsoft_ads_search_locations
Type	Action
Connection	microsoft_ads (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
account	object or array of object or MicrosoftAdsAccountItem or string or integer	Yes	-	Select a Microsoft Ads account to use for authorized location lookup.
search_terms	string	Yes	-	Location names or IDs to search for, separated by commas or newlines. Examples: United States, Dubai, London, 190.
location_type	string or SelectableOption	No	{'value': 'All', 'label': 'All'}	Optional Microsoft location type filter. Default: All.
status	string or SelectableOption	No	{'value': 'Active', 'label': 'Active'}	Optional status filter. Default: Active.
locale	string	No	en	Display-name locale for Microsoft geo locations. Default: en.
limit	integer	No	50	Maximum number of locations to return. Default: 50.

MicrosoftAdsAccountItem

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-
customerId	string	No	-	The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns Microsoft Ads geo locations matching the search terms.

Fields: location_id, name, display_name, location_type, status, adwords_location_id