Get ad analytics

Returns detailed performance analytics for an ad. Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta and TikTok only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.

GET /v1/ads/{adId}/analytics

Returns detailed performance analytics for an ad. Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta and TikTok only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.

Parameters

• adId (path, string) required

• fromDate (query, string) — Start of date range (YYYY-MM-DD). Defaults to 90 days ago.

• toDate (query, string) — End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.

• breakdowns (query, string) — Comma-separated breakdown dimensions. Meta: age, gender, country, publisher_platform, device_platform, region. TikTok: gender, age, country_code, platform, ac, language.

Responses

200 — Ad analytics

• ad (object)
• analytics (object)

401

403 — Ads access required. Legacy plans need the Ads add-on; included by default on usage-based plans.

404