Sign in
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
        }
      }
    ]
  }
}

Changes

Changed in 2 of the 26 revisions of this API.1115

  • 15e893e69e8c1See the full diff
    • ▲

      the backfillPending response property const value true was removed for the status 202

      response-property-const-removed

  • 5bcceb4c15ba115See the full diff
    • ●

      removed the optional property ad/trigger from the response with the 200 status

      response-optional-property-removed

    • ○

      added the media type application/json for the response with the status 202

      response-media-type-added

    • ○

      added the optional property analytics/daily/items/allOf[AdMetrics]/costPerAction to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/daily/items/allOf[AdMetrics]/inlineLinkClickCtr to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/daily/items/allOf[AdMetrics]/inlineLinkClicks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/daily/items/allOf[AdMetrics]/outboundClicks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/daily/items/allOf[AdMetrics]/outboundClicksCtr to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/daily/items/allOf[AdMetrics]/uniqueClicks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/daily/items/allOf[AdMetrics]/uniqueCtr to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/summary/costPerAction to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/summary/inlineLinkClickCtr to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/summary/inlineLinkClicks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/summary/outboundClicks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/summary/outboundClicksCtr to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/summary/uniqueClicks to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property analytics/summary/uniqueCtr to the response with the 200 status

      response-optional-property-added