> ## 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 Ad Groups

> Lists ad groups for an Amazon Ads profile across all sponsored ads products, with filtering options

Lists ad groups for an Amazon Ads profile across all sponsored ads products, with filtering options.

|                      |                             |
| -------------------- | --------------------------- |
| **App**              | Amazon Ads                  |
| **Operation ID**     | `amazon_ads_list_ad_groups` |
| **Type**             | Action                      |
| **Connection**       | `amazon_ads` (required)     |
| **Credits per run**  | 1                           |
| **Agent / MCP tool** | Yes                         |

## Inputs

| Field           | Type                                                    | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                       |
| --------------- | ------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`       | DynamicAccount                                          | Yes      | -       | Select the Amazon Ads profile whose ad groups should be listed.                                                                                                                                                                                                                                                                                                   |
| `ad_products`   | array of string or SelectableOption                     | No       | -       | Filter ad groups by ad product. Options: SPONSORED\_PRODUCTS, SPONSORED\_BRANDS, SPONSORED\_DISPLAY, SPONSORED\_TELEVISION. Defaults to all four when omitted.                                                                                                                                                                                                    |
| `entity_states` | array of string or SelectableOption                     | No       | -       | Filter ad groups by state. Options: ENABLED, PAUSED, ARCHIVED, DRAFT, PROPOSED. Defaults to ENABLED and PAUSED when omitted.                                                                                                                                                                                                                                      |
| `campaign_ids`  | array of string (also accepts a comma-separated string) | No       | -       | Optional campaign IDs to list ad groups for, as a list or comma-separated text. Up to 100.                                                                                                                                                                                                                                                                        |
| `ad_group_ids`  | array of string (also accepts a comma-separated string) | No       | -       | Optional ad group IDs to fetch, as a list or comma-separated text.                                                                                                                                                                                                                                                                                                |
| `name_contains` | string                                                  | No       | -       | Optional name filter: returns ad groups whose name matches the given text (Amazon broad match).                                                                                                                                                                                                                                                                   |
| `filters`       | array of FilterItem                                     | No       | -       | Additional filters to apply after retrieving ad groups. The available fields to filter by are: - adGroupId: Filter by ad group ID - campaignId: Filter by campaign ID - name: Filter by ad group name - state: Filter by ad group state Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP\_MATCH or IN\_LIST. |
| `limit`         | integer                                                 | No       | `100`   | Maximum number of ad groups to return. Default: 100.                                                                                                                                                                                                                                                                                                              |

### FilterItem

| Field      | Type                       | Required | Default | Description                                                                                                                                                   |
| ---------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `field`    | string or SelectableOption | Yes      | -       | The field to filter on, must be one of the current selected metrics or dimensions.                                                                            |
| `operator` | string                     | Yes      | -       | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' |
| `value`    | string                     | Yes      | -       | The value to filter by. Can be a string, number, regex, or a list of strings.                                                                                 |

### SelectableOption

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

## Output

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

Returns the raw list of Amazon Ads ad groups as provided by the Ads API v1 query/adGroups endpoint.