list_campaigns - Cometly API Docs

Returns a unified campaign list across Facebook, Google, LinkedIn, and TikTok.

When to use

“List my active campaigns.”
“Which campaigns are paused?”

For full detail on one campaign (creative, targeting, delivery), use get_ad_entity. For ranked performance rollups, use query_metric_breakdown.

Parameters

Parameter	Type	Required	Description
`sources`	string[]	No	Source slugs to include.
`status`	string	No	Filter by status (`active`, `paused`, …).
`name_like`	string	No	Case-insensitive substring filter on name.
`limit`	integer	No	Max rows total (1–500, default 200). Divided across the included sources.
`format`	string	No	`csv` (default), `json`, or `yaml`.

Output

source,id,account_id,name,status,objective,budget,updated_at
facebook_ads,1100012345,act_1234567890,Spring Launch,active,CONVERSIONS,150.00,2026-05-15T...
google_ads,1100098765,111-222-3333,Acme Brand Search,active,SEARCH,200.00,2026-05-15T...