AdspirerInstall

Summary

Retrieve Meta (Facebook) ad creative data filtered by ad account, optional campaign or ad set, and date range, with support for pagination and raw metrics output.

Inputs

• Platform (required) — Select 'Meta Ads' to enable fetching Meta ad creatives; must be set to 'metaAds' for this operation.
• Ad Account Id (required) — The Meta Ad Account ID to retrieve ad creatives for.
• Ad Set Id — Optional filter to narrow results to a specific ad set ID.
• Campaign Id — Optional filter to narrow results to a specific campaign ID.
• Date Range — Preset date range strings (like 'last_7_days', 'last_14_days') to filter creatives by date.
• Start Date — Custom start date (YYYY-MM-DD) for filtering ad creatives.
• End Date — Custom end date (YYYY-MM-DD) for filtering ad creatives.
• Lookback Days — Number of days (7,14,30,60,90) to analyze; alternative way to specify the date range.
• Limit — Maximum number of ads to return per page; defaults to 20, maximum 50.
• Offset — Number of ads to skip for pagination; defaults to 0.
• Raw Data — When true, returns only raw metrics (spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS) in JSON format.

Output shape

a JSON object containing a list of Meta ad creatives with their metadata and optionally aggregated metrics

Supports pagination via 'limit' and 'offset' parameters; if 'Raw Data' is true, output is a JSON code block of raw metrics instead of full structured data.

Examples

Example 1: Fetch the first 30 ad creatives from a Meta ad account filtered by campaign ID and date range 'last_30_days'.

Set Platform to 'Meta Ads', enter the Ad Account ID, optionally specify the Campaign ID, set Date Range to 'last_30_days', and Limit to '30'.

Links

• n8n community nodes installation guide