Ad Insights

Submit async insights report

Changed on

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

post/v1/ads/insights/reports

Request

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

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). Pass none to clear Meta's default action_type breakdown, needed for some non-action breakdowns such as instagram_ads_follow_type.

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

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • info

      added the media type application/json for the response with the status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status