Ads
List ads
Metric fields (spent, impressions, clicks, conversions, leads, purchase_value, ctr, cpa, roas) cover the last 28 days, on every platform. That is the window the ad networks give us daily figures for, so it is the longest total we can report without inventing the missing days - it is NOT the campaign’s lifetime. For any other date range, or a per-campaign breakdown of one, use GET /ads/analytics. Requires scope ads:read.
GET
List ads
Authorizations
API key from Developer dashboard (Bearer token).
Query Parameters
Available options:
meta, google, tiktok, linkedin Example:
"meta"
Match against name.
Available options:
image, video, carousel, text Example:
1
Required range:
x <= 100Example:
20

