> ## 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 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**:

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