v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

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

post/v1/ads/insights/reports

Request body

accountIdstring required

Zernio SocialAccount id (posting or ads variant).

objectIdstring required

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

level'ad' | 'adset' | 'campaign' | 'account'

fieldsstring

Comma-separated Graph insights fields.

breakdownsstring

Comma-separated Graph breakdowns.

actionBreakdownsstring

Comma-separated Graph action breakdowns (e.g. action_type,action_destination).

actionAttributionWindowsstring[]

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

actionReportTimestring

When actions are counted: impression, conversion or mixed.

useUnifiedAttributionSettingboolean

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

datePresetstring

Mutually exclusive with fromDate/toDate.

fromDatestring date

toDatestring date

Response

Report run submitted

reportRunIdstring

statusstring

Example response

{
  "status": "Job Started"
}