Meta Ads icon

Meta Ads

Access Meta Ads Marketing API

Actions20

Insights → Get

AI-generated

Summary

Retrieve aggregated advertising insights for a specified Meta ad account at a chosen level within a given date range, optionally broken down by demographic or device categories.

Inputs

  • Ad Account ID (required) — The numeric ID of the Meta ad account (excluding the 'act_' prefix) from which to retrieve insights.
  • Level (required) — The granularity level for insight aggregation: account, campaign, ad set, or ad.
  • Date Range (required) — The relative date range over which insights data is collected, such as 'last_30d' or 'today'.
  • Breakdowns — Optional demographic or device dimensions to segment the insights results, e.g., age, country, gender.

Output shape

a single record containing aggregated insights data for the specified parameters

The output includes metrics aggregated at the specified level and date range, and respects any breakdown dimensions. The API request uses the appropriate endpoint URL based on the chosen level. No pagination or batched output is indicated for this operation.

Links

Discussion