Skip to main content

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.

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

ParameterTypeRequiredDescription
sourcesstring[]NoSource slugs to include.
statusstringNoFilter by status (active, paused, …).
name_likestringNoCase-insensitive substring filter on name.
limitintegerNoMax rows total (1–500, default 200). Divided across the included sources.
formatstringNocsv (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...