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

> Lists the ad groups and campaigns currently targeting an X Ads custom audience

Lists the ad groups and campaigns currently targeting an X Ads custom audience.

|                      |                             |
| -------------------- | --------------------------- |
| **App**              | X Ads                       |
| **Operation ID**     | `x_ads_list_audience_usage` |
| **Type**             | Action                      |
| **Connection**       | `x_ads` (required)          |
| **Credits per run**  | 1                           |
| **Agent / MCP tool** | Yes                         |

## Inputs

| Field         | Type                 | Required | Default | Description                                                                                     |
| ------------- | -------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------- |
| `account`     | DynamicAccount       | Yes      | -       | Select the X Ads account that owns the audience.                                                |
| `audience_id` | string or SelectItem | Yes      | -       | Custom audience ID to check usage for.                                                          |
| `active_only` | boolean              | No       | `True`  | Only list ad groups that are currently active (default). Turn off to include inactive ones too. |
| `limit`       | integer              | No       | `100`   | Maximum number of records 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 ad groups and campaigns targeting the audience.

**Fields**: dynamic (depend on the inputs)