AdspirerInstall

Summary

Retrieve detailed audience insights for Meta Ads platform ad accounts, specifying breakdowns by age, gender, placement, device, or all categories over defined date ranges.

Inputs

• Platform (required) — Select the advertising platform (must be 'Meta Ads' for this operation).
• Ad Account Id (required) — The Meta Ad Account ID from which to fetch audience insights.
• Breakdown Type — Specify the type of demographic breakdown: 'age', 'gender', 'placement', 'device', or 'all' (default).
• Date Range — Predefined date range preset for the data (e.g., 'last_7_days', 'last_14_days', 'last_30_days', 'last_60_days', 'last_90_days').
• Start Date — Custom start date (YYYY-MM-DD) to define the beginning of the analysis period.
• End Date — Custom end date (YYYY-MM-DD) to define the end of the analysis period.
• Lookback Days — Number of days to analyze (7, 14, 30, 60, or 90). If provided, it overrides or complements date range settings.
• Raw Data — If true, returns only raw performance metrics like spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, and ROAS organized by campaign, ad, and date.

Output shape

a JSON object containing audience insights data from the specified Meta Ad account, optionally broken down by demographic or device categories as requested.

The output includes metrics aggregated according to the requested breakdown. If 'Raw Data' is true, the response contains a JSON code block with raw metrics only. Date range parameters can be combined or left blank to use defaults; when conflicting, explicit start and end dates take precedence. Errors related to invalid or missing Meta Ad Account IDs are expected to be surfaced by the node execution environment.

Examples

Example 1: Fetch audience insights broken down by gender for the last 30 days for a given Meta Ad Account.

Set 'Platform' to 'Meta Ads', input the Meta Ad Account ID, set 'Breakdown Type' to 'gender', and select 'Date Range' as 'last_30_days'.

Links

• n8n community nodes installation guide