Zernio
APIFor you
Zernio
APIFor you
API Reference

Insights

List lead conversationsGETGoogle Local Services Ads leadsGETSubmit async insights reportPOSTGet ad analyticsGETPoll an async insights report runGETGoogle Ads search terms reportGETGet campaign analyticsGETPer-creative performance inside TikTok Smart+ adsGETGet historical keyword metricsPOSTGenerate keyword ideasPOSTFlexible live insights queryGET
Dashboard
OverviewPlatformsAPI ReferenceResources
Insights

Submit async insights report

Starts a background Meta insights report for long date ranges or large accounts where a live query would be too slow.

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}.


PlatformsMeta
POST
/v1/ads/insights/reports

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

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": "string"}
Was this page helpful?

Google Local Services Ads leads

Lists the calls, messages and bookings your Google Local Services Ads generated, newest first. Leads generated by Local Services Ads (phone calls, messages, bookings), read live from Google's `local_services_lead` resource, newest first. No persistence: Google is the source of truth and lead/credit statuses keep changing server-side. Google never returns healthcare-category leads, and `WIPED_OUT` leads arrive with contact erased (`contact` is null). Draws on the shared Google Ads operations budget.

Get ad analytics

Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta, TikTok and LinkedIn. Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta, TikTok and LinkedIn only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max. History: when an ad account connects, Zernio imports its last 90 days of metrics. `summary` and `daily` come from those synced metrics, so they hold no data for days before that. Breakdowns are read live from the platform over the requested range, so they are not limited by the import. When the ad belongs 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`.

accountId*string

Zernio SocialAccount id (posting or ads variant).

objectId*string

Meta insights node: act_, campaign id, ad set id or ad id.

level?string

Value in

  • "ad"
  • "adset"
  • "campaign"
  • "account"
fields?string

Comma-separated Graph insights fields.

breakdowns?string

Comma-separated Graph breakdowns.

actionBreakdowns?string

Comma-separated Graph action breakdowns (e.g. action_type,action_destination). Pass none to clear Meta's default action_type breakdown, needed for some non-action breakdowns such as instagram_ads_follow_type.

actionAttributionWindows?array<string>

Meta attribution windows (e.g. ["7d_click", "1d_view"]). Action values are returned keyed per window.

actionReportTime?string

When actions are counted: impression, conversion or mixed.

useUnifiedAttributionSetting?boolean

Use the ad sets' own attribution settings for action counting.

filtering?array<>

Meta filter objects, applied server-side.

datePreset?string

Mutually exclusive with fromDate/toDate.

fromDate?string
Formatdate
toDate?string
Formatdate
timeIncrement?|