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

> Search or list Pinterest Ads targeting options such as interests, locations, regions, languages, devices, and audiences

Search or list Pinterest Ads targeting options such as interests, locations, regions, languages, devices, and audiences. Returned IDs plug directly into the matching targeting\_spec key of pinterest\_ads\_create\_ad\_group.

|                      |                                  |
| -------------------- | -------------------------------- |
| **App**              | Pinterest Ads                    |
| **Operation ID**     | `pinterest_ads_search_targeting` |
| **Type**             | Action                           |
| **Connection**       | `pinterest_ads` (required)       |
| **Credits per run**  | Free                             |
| **Agent / MCP tool** | Yes                              |

## Inputs

| Field            | Type                       | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                    |
| ---------------- | -------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`        | DynamicAccount             | Yes      | -       | Select Pinterest Ads account to search targeting options for.                                                                                                                                                                                                                                                                                                  |
| `targeting_type` | string or SelectableOption | Yes      | -       | Which targeting dimension to search. The returned IDs go directly into the matching create\_ad\_group targeting\_spec key: INTEREST (interest IDs), LOCATION (country and metro codes), GEO (region and postal codes), LOCALE (language codes), APPTYPE (devices), GENDER, AGE\_BUCKET, AUDIENCE\_INCLUDE or AUDIENCE\_EXCLUDE (the account's customer lists). |
| `search_query`   | string                     | No       | -       | Optional text filter. Pinterest returns the full list per targeting type, so Markifact filters it: case-insensitive name substring match, or exact ID match.                                                                                                                                                                                                   |
| `limit`          | integer                    | No       | `100`   | Maximum rows to return, sorted by name. Default 100, max 1000.                                                                                                                                                                                                                                                                                                 |

### SelectableOption

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

## Output

**Type**: `List[Dict]`

Returns Pinterest targeting options normalized for use in ad group targeting\_spec keys.

**Fields**: `id`, `name`, `targeting_type`