Ad Campaigns

Get daily account metrics

Changed on

Returns an ads account's spend, results and other metrics day by day, ready for a daily performance chart.

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), the same convention as /v1/ads/tree and /v1/ads.

Date range defaults to the last 90 days. Capped at 730 days.

History: when an ad account connects, Zernio imports its last 90 days of metrics, so rows hold no data for days before that. When accountId or adAccountId resolves to a Meta ad account, a range reaching further back answers 202 with backfillPending: true and the covered part while the older days (up to 730 days back) are imported in the background; repeat the request until it returns 200. Other platforms never return 202.

With adAccountId set to a Google customer id this is the customer-level performance report (clicks, cost, impressions, conversions, all conversions per day).

get/v1/ads/timeline

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/timeline
  • Auth: HTTP bearer

Query parameters

accountIdstring required

Account ID. Sibling-expanded to its linked posting↔ads pair. An id that does not exist or sits on a profile the API key cannot reach answers 404 (code: account_not_found).

adAccountIdstring

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.

fromDatestring date

Inclusive start of metrics range (YYYY-MM-DD). Defaults to 90 days ago.

toDatestring date

Inclusive end of metrics range (YYYY-MM-DD). Defaults to today. Max 730-day range.

platform'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' | 'reddit'

Restrict to one platform.

Response

Daily time series of aggregate metrics. Empty rows means the account has no ad activity in the range.

backfillPendingboolean

Meta only. Present and true while historical data is being backfilled.

Changes