v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Ad Insights

Get ad analytics

Returns detailed performance analytics for an ad. Includes summary metrics, a daily timeline over the requested date range, and optional demographic breakdowns (Meta and TikTok only). If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.

get/v1/ads/{adId}/analytics

Path parameters

adIdstring required

Query parameters

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.

TikTok: gender, age, country_code, platform, ac, language.

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

Ad 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
        }
      }
    ]
  }
}