> ## 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...
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.