> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# list_ads

> Individual ads / creatives across connected ad platforms.

Returns the ad-level entities (Meta ads, Google ads, TikTok ads, LinkedIn creatives, Reddit ads, X ads, Whop ads).

## When to use

* "List ads in this adset."
* "Which creatives are currently active?"

For full creative + targeting detail on one ad, use [`get_ad_entity`](/mcp/tools/get-ad-entity).

## Parameters

| Parameter   | Type      | Required | Description                                |
| ----------- | --------- | -------- | ------------------------------------------ |
| `sources`   | string\[] | No       | Source slugs to include.                   |
| `adset_id`  | string    | No       | Limit to a single adset / ad group.        |
| `name_like` | string    | No       | Case-insensitive substring filter on name. |
| `status`    | string    | No       | Filter by status.                          |
| `limit`     | integer   | No       | Max rows (1–500, default 200).             |
| `format`    | string    | No       | `csv` (default), `json`, or `yaml`.        |

## Output

```csv theme={null}
source,id,adset_id,name,status,updated_at
facebook_ads,1300012345,1200012345,Spring Hero Image v3,active,2026-05-15T...
google_ads,1300098765,1200098765,Brand RSA,active,2026-05-15T...
```