Sign in

v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad Insights

Get campaign analytics

Returns performance analytics for a whole campaign in one call: summary metrics, a daily timeline over the requested date range (summed across the campaign's ads), and optional demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc. without summing thousands of per-ad reads. campaignId is the platform campaign id; pass platform when a campaign id could be ambiguous across platforms. If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.

get/v1/ads/campaigns/{campaignId}/analytics

Path parameters

campaignIdstring required

Platform campaign id (platformCampaignId).

Query parameters

platformstring

Disambiguate when the campaign id exists across platforms (e.g. facebook, instagram).

fromDatestring date

Start of date range (YYYY-MM-DD). Defaults to 90 days ago.

toDatestring date

End of date range (YYYY-MM-DD). Defaults to today. Max 730-day range.

breakdownsstring

Comma-separated breakdown dimensions.

Meta: age, gender, country, publisher_platform, device_platform, region, platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.

LinkedIn (firmographics): job_title, job_function, seniority, industry, company, company_size, country, region. Rows carry the raw pivot value plus a resolved name. LinkedIn serves these aggregated over the whole range, delays the data 12-24h, and omits segments with fewer than 3 events.

Response

Campaign analytics

backfillPendingboolean

Present and true only on 202 responses: part of the requested date range is still being backfilled from the platform in the background. Retry the same request shortly; it returns 200 once the range is fully ingested.

Example response

{
  "analytics": {
    "summary": {
      "actions": {
        "link_click": 160,
        "post_engagement": 300,
        "offsite_conversion.fb_pixel_purchase": 42
      },
      "actionValues": {
        "offsite_conversion.fb_pixel_purchase": 2456.78,
        "offsite_conversion.fb_pixel_add_to_cart": 980.5
      }
    },
    "daily": [
      {
        "actions": {
          "link_click": 160,
          "post_engagement": 300,
          "offsite_conversion.fb_pixel_purchase": 42
        },
        "actionValues": {
          "offsite_conversion.fb_pixel_purchase": 2456.78,
          "offsite_conversion.fb_pixel_add_to_cart": 980.5
        }
      }
    ]
  }
}