Zernio
Zernio
API Reference

Insights

Conversations of a Local Services leadGETGoogle Local Services Ads leadsGETSubmit an async insights report runPOSTGet ad analyticsGETPoll an async insights report runGETGoogle Ads search terms reportGETGet campaign analyticsGETHistorical keyword metrics (Google Keyword Planner)POSTGenerate keyword ideas (Google Keyword Planner)POSTFlexible live insights queryGET
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Insights

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

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

{  "reportRunId": "string",  "status": "string"}
Was this page helpful?

Google Local Services Ads leads

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

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

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?|