Meta Insights icon

Meta Insights

Get insights from Facebook Ads, Facebook Pages, and Instagram

Actions6

Facebook Ads (Campaign)

AI-generated

Summary

Fetches Facebook Ads insights for an ad account at campaign, ad set, or ad level, with an optional date preset, date range, field list, and JSON filter. Returns each Graph API insight row as an n8n item; an empty result is returned as one item containing the response object.

Inputs

  • Ad Account ID (required) — Facebook ad account ID, including the act_ prefix.
  • Fields — Comma-separated Graph API insight fields. If blank, requests the node’s default campaign metrics, including spend, impressions, reach, clicks, actions, and cost metrics.
  • Date Preset (required) — Selects the reporting period. Defaults to Last Week (Mon–Sun). The chosen preset is sent as date_preset.
  • Level (required) — Groups insights by Campaign, Ad Set, or Ad. Defaults to Campaign.
  • Filtering — Optional JSON array of Graph API filter objects, passed through as filtering.
  • Additional Options — Optional Since and Until dates in YYYY-MM-DD format, and a Limit for results per page (default 25). These are sent as query parameters when provided.
  • Graph API Version — Graph API version used in the request; defaults to v25.0.

Output shape

A list of items, one per insight row returned by the Graph API.

If the API returns no rows, the operation emits one item containing the full response object. Requires Facebook Graph API credentials. API errors fail the operation unless Continue On Fail is enabled, in which case an item with an error field is returned.

Links

Discussion