> ## 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 Audience Segments

> List Google Ads audience segments by type with optional name search and result limit

List Google Ads audience segments by type with optional name search and result limit. Supports: USER\_LIST, AFFINITY, IN\_MARKET, LIFE\_EVENT, DETAILED\_DEMOGRAPHICS, CUSTOM\_AUDIENCE, COMBINED\_AUDIENCE, AUDIENCE (reusable Audience entities used as PMax/Demand Gen signals), or ALL.

|                      |                               |
| -------------------- | ----------------------------- |
| **App**              | Google Ads                    |
| **Operation ID**     | `gads_list_audience_segments` |
| **Type**             | Action                        |
| **Connection**       | `gads` (required)             |
| **Credits per run**  | Free                          |
| **Agent / MCP tool** | Yes                           |

## Inputs

| Field          | Type                                                              | Required | Default | Description                                                                                                                                        |
| -------------- | ----------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`      | GadsAccountItem or object or array of object or string or integer | Yes      | -       | Select the Google Ads account, ask user for it if not provided                                                                                     |
| `segment_type` | string or SelectableOption                                        | No       | -       | Audience segment type to list as per the Enum AudienceSegmentType. Note: 'AUDIENCE' is reusable Audience entities used as PMax/Demand Gen signals. |
| `search_term`  | string                                                            | No       | -       | Optional search term to filter audience names                                                                                                      |
| `limit`        | integer                                                           | No       | -       | Maximum number of segments to return                                                                                                               |

### GadsAccountItem

| Field       | Type   | Required | Default | Description                                                                                                                                                    |
| ----------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `value`     | string | Yes      | -       |                                                                                                                                                                |
| `label`     | string | Yes      | -       |                                                                                                                                                                |
| `managerId` | string | Yes      | -       | The manager ID for the Google Ads account. Ask  user to use the dropdown to select accounts, this manager id is selected background and not shown to the user. |

### SelectableOption

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

## Output

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

Returns audience segments.

**Fields**: `type`, `id`, `name`, `resource_name`