Submit an async insights report run
Submits an asynchronous Meta insights report. Same query surface as GET /v1/ads/insights, but
in the JSON body; Meta processes the report server-side, which is the right choice for long
ranges or large accounts where the sync query is slow or rate-limited. Returns a reportRunId
to poll via GET /v1/ads/insights/reports/{reportRunId}.
API key authentication - use your Zernio API key as a Bearer token
In: header
Zernio SocialAccount id (posting or ads variant).
Meta insights node: act_, campaign id, ad set id or ad id.
"ad" | "adset" | "campaign" | "account"Comma-separated Graph insights fields.
Comma-separated Graph breakdowns.
Comma-separated Graph action breakdowns (e.g. action_type,action_destination).
Meta attribution windows (e.g. ["7d_click", "1d_view"]). Action values are returned keyed per window.
When actions are counted: impression, conversion or mixed.
Use the ad sets' own attribution settings for action counting.
Meta filter objects, applied server-side.
Mutually exclusive with fromDate/toDate.
datedateResponse Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.adinsights.createAdInsightsReport({ body: { accountId: 'account_abc123', objectId: 'object_abc123', },});console.log(data);{
"reportRunId": "string",
"status": "Job Started"
}{
"error": "Unauthorized"
}Estimate audience reach POST
Returns a normalized pre-flight audience-size estimate for a targeting spec, before any campaign is created. Backed by each platform's native reach API (Meta `delivery_estimate`, LinkedIn `audienceCounts`, X `audience_summary`, Pinterest `audience_sizing`). Platforms without a usable pre-flight reach API (Google Search/Display, TikTok) return `available: false` with no bounds, so clients can hide or grey out the estimate rather than treat the absence as an error.
Get ad analytics GET
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.