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

> Lists Reddit Ads ads with full details, filterable by campaign, ad group, and status

Lists Reddit Ads ads with full details, filterable by campaign, ad group, and status.

|                      |                         |
| -------------------- | ----------------------- |
| **App**              | Reddit Ads              |
| **Operation ID**     | `reddit_ads_list_ads`   |
| **Type**             | Action                  |
| **Connection**       | `reddit_ads` (required) |
| **Credits per run**  | 1                       |
| **Agent / MCP tool** | Yes                     |

## Inputs

| Field          | Type                 | Required | Default | Description                                                                                                    |
| -------------- | -------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------- |
| `account`      | DynamicAccount       | Yes      | -       | Select the Reddit Ads account to list ads for.                                                                 |
| `campaign_id`  | string or SelectItem | No       | -       | Optionally filter to ads of a single campaign ID.                                                              |
| `ad_group_id`  | string or SelectItem | No       | -       | Optionally filter to ads of a single ad group ID.                                                              |
| `statuses`     | string               | No       | -       | Optional comma-separated configured statuses to filter by. Options: 'ACTIVE', 'PAUSED', 'ARCHIVED', 'DELETED'. |
| `search_query` | string               | No       | -       | Optional text filter applied to ads names (case-insensitive substring match).                                  |
| `limit`        | integer              | No       | `100`   | Maximum number of ads 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 list of ads.

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