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

# List Keywords

> Lists keywords for a Pinterest Ads account, optionally scoped to a campaign or ad group and filtered by match type

Lists keywords for a Pinterest Ads account, optionally scoped to a campaign or ad group and filtered by match type. Returns keyword IDs for use with pinterest\_ads\_update\_keywords.

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

## Inputs

| Field         | Type                                                    | Required | Default | Description                                                                                                                                                                   |
| ------------- | ------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`     | DynamicAccount                                          | Yes      | -       | Select the Pinterest Ads account whose keywords should be listed.                                                                                                             |
| `campaign_id` | string or SelectItem                                    | No       | -       | Optional campaign ID to list keywords from (campaign-level negative keywords).                                                                                                |
| `ad_group_id` | string or SelectItem                                    | No       | -       | Optional ad group ID to list keywords from.                                                                                                                                   |
| `match_types` | array of string (also accepts a comma-separated string) | No       | -       | Optional match types to filter by, as a list or comma-separated text. Options: BROAD, PHRASE, EXACT, EXACT\_NEGATIVE, PHRASE\_NEGATIVE. Returns all match types when omitted. |
| `limit`       | integer                                                 | No       | `100`   | Maximum number of keywords to return. Default: 100.                                                                                                                           |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

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

Returns the raw list of Pinterest keywords with id, value, match\_type, parent\_id, and archived.