Get ad analytics overview
Returns merged ads analytics (funnel plus channel spend/ROAS/CPM) for one ad, channel, account, and date range. Requires a connected ads account; use ads.getFunnel for a DB-only funnel without spend data.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Start date (YYYY-MM-DD, inclusive).
^\d{4}-\d{2}-\d{2}$End date (YYYY-MM-DD, inclusive).
^\d{4}-\d{2}-\d{2}$IANA timezone used to bucket results.
Restrict to this Meta ad account id (act_). Get it from ads.listChannelAdAccounts.
^act_\d+$Restrict to this channel.
whatsapp, messenger, instagram Restrict to this WhatsApp integration.
^\d+$Restrict to this Messenger integration.
^\d+$Restrict to this Instagram integration.
^\d+$Aggregate across every channel instead of one. Mutually exclusive with channel/integration filters.