Actions119
- Analyze Search Terms
- Analyze Wasted Spend
- Explain Performance Anomaly
- Get Benchmark Context
- Get Business Profile
- Get Campaign Performance
- Get Campaign Structure
- Get Campaign Targeting
- Get Pmax Audience Signals
- Get Pmax Search Themes
- Get Usage Status
- Help User Upload
- Infer Business Profile
- List Campaign Extensions
- List Campaigns
- Optimize Budget Allocation
- Pause Ad
- Pause Campaign
- Remove Pmax Audience Signal
- Resume Ad
- Resume Campaign
- Save Business Profile
- Search Audiences
- Select Google Campaign Type
- Update Bid Strategy
- Update Campaign
- Update Keyword
- Validate Video
- Analyze Meta Ad Performance
- Analyze Meta Audiences
- Analyze Meta Wasted Spend
- Browse Meta Targeting
- Detect Meta Creative Fatigue
- Discover Meta Assets
- Duplicate Meta Campaign
- Explain Meta Anomaly
- Get Meta Ad Creatives
- Get Meta Audience Insights
- Get Meta Campaign Details
- Get Meta Campaign Performance
- Get Meta Lead Form Submissions
- List Meta Ad Sets
- List Meta Ads
- List Meta Campaigns
- List Meta Custom Audiences
- List Meta Instagram Accounts
- List Meta Lead Forms
- List Meta Pixels
- Optimize Meta Budget
- Optimize Meta Placements
- Pause Meta Campaign
- Resume Meta Campaign
- Select Meta Campaign Type
- Update Meta Ad
- Update Meta Campaign
- Add Linkedin Creative
- Add Linkedin Text Creative
- Add Linkedin Video Creative
- Analyze Linkedin Creative Performance
- Analyze Linkedin Wasted Spend
- Associate Linkedin Conversion
- Delete Linkedin Creative
- Discover Linkedin Assets
- Explain Linkedin Anomaly
- Explain Linkedin Objectives
- Generate Linkedin Ad Creatives
- Get Linkedin Campaign Performance
- Get Linkedin Campaign Structure
- Get Linkedin Campaign Targeting
- Get Linkedin Engagement Metrics
- Get Linkedin Organizations
- List Linkedin Campaign Groups
- List Linkedin Campaigns
- List Linkedin Conversions
- List Linkedin Creatives
- Manage Linkedin Conversions
- Optimize Linkedin Budget
- Pause Linkedin Campaign
- Pause Linkedin Creative
- Resume Linkedin Campaign
- Resume Linkedin Creative
- Search Linkedin Targeting
- Select Linkedin Campaign Type
- Update Linkedin Campaign Budget
- Update Linkedin Campaign Group
- Update Linkedin Campaign Schedule
- Update Linkedin Creative
- Analyze Tiktok Geo Performance
- Analyze Tiktok Wasted Spend
- Detect Tiktok Creative Fatigue
- Discover Tiktok Assets
- Explain Tiktok Anomaly
- Get Tiktok Ad Performance
- Get Tiktok Audience Insights
- Get Tiktok Campaign Details
- Get Tiktok Campaign Performance
- List Tiktok Ad Groups
- List Tiktok Ads
- List Tiktok Campaigns
- Optimize Tiktok Budget
- Pause Tiktok Ad
- Pause Tiktok Ad Group
- Pause Tiktok Campaign
- Resume Tiktok Ad
- Resume Tiktok Ad Group
- Resume Tiktok Campaign
- Update Tiktok Campaign
- Audit Conversion Tracking
- Delete Monitor
- Get Connections Status
- Get Monitor History
- Get Research Status
- List Connected Accounts
- List Monitors
- List Pending Actions
- List Scheduled Tasks
- Manage Action
- Manage Scheduled Task
- Test Monitor
Analyze Meta Audiences
AI-generatedSummary
Analyze advertising audience performance on Meta Ads by retrieving metrics broken down by age, gender, or both over specified date ranges, optionally including saturation analysis for lookalike and custom audiences.
Inputs
- Platform (required) — Select the advertising platform; 'Meta Ads' is required for this operation.
- Ad Account Id (required) — The Meta Ad Account ID to analyze.
- Breakdown Type — Audience breakdown type: 'age', 'gender', 'age_gender', or 'all' (default).
- Date Range — Predefined date range presets such as 'last_7_days', 'last_14_days', 'last_30_days', 'last_60_days', or 'last_90_days'.
- Start Date — Custom analysis start date in YYYY-MM-DD format; overrides Date Range if provided.
- End Date — Custom analysis end date in YYYY-MM-DD format; overrides Date Range if provided.
- Include Saturation — Boolean flag to include saturation analysis for lookalike and custom audiences, defaulting to true.
- Lookback Days — Numeric string (7, 14, 30, 60, or 90) specifying number of days to analyze; optional alternative to Date Range.
- Raw Data — If true, returns only raw performance metrics as a JSON code block including spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, and ROAS by campaign, ad, and date.
- Target Roas — Optional numeric string to override target ROAS for the analysis (e.g., '3.0' for 3.0x ROAS).
Output shape
a JSON object containing analyzed audience metrics broken down by the selected criteria and date range or raw JSON metrics if requested
The output shape depends on the 'Raw Data' input: if true, returns raw performance metrics JSON; otherwise, returns processed audience breakdown analysis including optional saturation data. Date parameters are mutually exclusive—using 'Start Date' and 'End Date' will override 'Date Range'. Only applicable when 'Platform' is set to 'Meta Ads'.
Examples
Example 1: Analyze Meta Ads audiences by combined age and gender over the last 30 days including saturation data, returning processed analysis
Platform=Meta Ads, Breakdown Type=age_gender, Date Range=last_30_days, Include Saturation=true, Raw Data=false
Example 2: Retrieve raw performance metrics for a Meta Ads account over a custom date range
Platform=Meta Ads, Ad Account Id=