Get daily account metrics
Returns daily aggregate metrics across all ads in a SocialAccount as a single
time series — one row per calendar day in the requested range. Use this for
dashboards that draw a daily-spend or daily-conversions chart, instead of
calling /v1/ads/tree once per day.
accountId is required. The lookup is sibling-expanded so passing the metaads
ID also includes ads under the linked facebook / instagram posting account
(and vice-versa) — same convention as /v1/ads/tree and /v1/ads.
Date range defaults to the last 90 days. Capped at 730 days. Ranges older
than the ingested history return a 202 immediately with the covered part
and backfillPending: true while the rest is backfilled in the background;
repeat the request shortly until it returns 200 with full data.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
Social account ID. Sibling-expanded to its linked posting↔ads pair.
Optional platform-native ad account ID (e.g. Meta act_…, TikTok advertiser ID). Use when the connection wraps multiple platform ad accounts and the chart should show one only. Note: rows ingested before 2026-05-13 don't carry this column; the recurring 7-day re-sync repopulates them naturally.
Inclusive start of metrics range (YYYY-MM-DD). Defaults to 90 days ago.
dateInclusive end of metrics range (YYYY-MM-DD). Defaults to today. Max 730-day range.
dateRestrict to one platform.
"facebook" | "instagram" | "tiktok" | "linkedin" | "pinterest" | "google" | "twitter"Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adcampaigns.getAdsTimeline({ query: { accountId: 'account_abc123', },});console.log(data);{
"rows": [
{
"date": "2019-08-24",
"spend": 0,
"impressions": 0,
"reach": 0,
"clicks": 0,
"engagement": 0,
"ctr": 0,
"cpc": 0,
"cpm": 0,
"conversions": 0,
"costPerConversion": 0,
"actions": {
"property1": 0,
"property2": 0
},
"actionValues": {
"property1": 0,
"property2": 0
},
"purchaseValue": 0,
"roas": 0
}
],
"backfillPending": true
}{
"error": "Unauthorized"
}Get campaign tree GET
Returns a nested Campaign > Ad Set > Ad hierarchy with rolled-up metrics at each level. Uses a two-stage aggregation: ads are grouped into ad sets, then ad sets into campaigns. Metrics are computed over an optional date range, then rolled up from ad level to ad set and campaign levels. Pagination is at the campaign level. Ads without a campaign or ad set ID are grouped into synthetic "Ungrouped" buckets. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. Pass `timeIncrement=1` to also get a daily breakdown: each node gains a `daily[]` array of per-day metrics (same fields as the aggregated `metrics`) in the same call. Use `dailyLevel` (`campaign` default, or `adset` / `ad`) to choose which levels carry the series. This replaces calling the tree once per day for per-campaign daily trends.
Get campaign analytics GET
Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass `platform` when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.