Sign in
OpenAPI 3.1.02026-08-185681822.2 MB

d0ab3b4eb0ae

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 while historical data is being backfilled.

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
      },
      "costPerAction": {
        "link_click": 0.1052,
        "offsite_conversion.fb_pixel_purchase": 4.0114
      }
    },
    "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
        },
        "costPerAction": {
          "link_click": 0.1052,
          "offsite_conversion.fb_pixel_purchase": 4.0114
        }
      }
    ]
  }
}