Adspirer icon

Adspirer

Manage ad campaigns across Google, Meta, LinkedIn & TikTok Ads via the Adspirer REST API

Actions119

Get Meta Campaign Performance

AI-generated

Summary

Retrieve Meta Ads campaign performance data for a specified ad account and date range, optionally including optimization recommendations and detailed raw metrics.

Inputs

  • Platform (required) — Select the advertising platform; for this operation, select 'Meta Ads'.
  • Ad Account Id (required) — The Meta Ad Account ID for which to retrieve campaign performance data.
  • Date Range — A preset string specifying the date range (e.g., 'last_7_days', 'last_14_days', etc.) for performance data.
  • Start Date — The start date (YYYY-MM-DD) for the custom date range.
  • End Date — The end date (YYYY-MM-DD) for the custom date range.
  • Include Recommendations — Boolean flag indicating whether to include optimization recommendations with the performance data. Defaults to true.
  • Lookback Days — Numeric string for the number of days (7, 14, 30, 60, or 90) to analyze; optional and used if provided.
  • Raw Data — Boolean flag to return only raw metrics as JSON code block (spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS) by campaign/ad/date; defaults to false.

Output shape

a JSON object with Meta Ads campaign performance data potentially including summary metrics and/or raw detailed metrics depending on 'Raw Data' input; may include optimization recommendations if requested.

Date range can be specified either via presets ('Date Range') or custom start/end dates. The operation returns structured performance data; setting 'Raw Data' to true limits output to raw numerical metrics only. Input fields other than 'Platform' and 'Ad Account Id' are optional and affect output detail and range.

Links

Discussion