> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`