list_ads - Cometly API Docs

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.

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

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