Meta Insights icon

Meta Insights

Get insights from Facebook Ads, Facebook Pages, and Instagram

Actions6

Instagram Paid

AI-generated

Summary

Fetches Instagram ad campaign insights for the specified Meta ad account, then aggregates the results into one item after filtering to Instagram placements and any matching campaign names or calendar week.

Inputs

  • Ad Account ID (required) — Meta ad account ID, including the act_ prefix.
  • Date Mode — Choose a date preset or custom range. Presets include common day, week, month, quarter, and year ranges; the default is Last Week (Mon–Sun).
  • Date Preset — Select the reporting period when Date Mode is Date Preset.
  • Since — Start date in YYYY-MM-DD format when Date Mode is Custom Range. If omitted, no start date is sent.
  • Until — End date in YYYY-MM-DD format when Date Mode is Custom Range. If omitted, no end date is sent.
  • Campaign Name Filter — Include only campaigns whose names contain this text, ignoring letter case. Leave empty to include all Instagram placement campaigns.
  • Auto KW Filter — When enabled and a start date is available, include only campaigns whose names contain the ISO calendar week text, such as kw 18. The week is derived from the selected preset's start date or the custom Since date.
  • Graph API Version — Meta Graph API version used for the request; defaults to v25.0. A Facebook Graph API credential is also required.

Output shape

A single item per input item, containing aggregated Instagram paid campaign insights.

The item includes platform, spend, impressions, reach, clicks, video_views, leads, ctr, cpc, cpm, cpf, frequency, date_start, date_stop, and debug campaign and row-count fields. Metric totals are aggregated across matching campaign rows; rate metrics are calculated from those totals. The operation fetches all API pages before filtering. Errors are thrown unless the node is configured to continue on fail.

Links

Discussion