Get ad analytics

GET 
/ad-publishing/linkedin/reporting

Retrieve LinkedIn Ads analytics data with configurable pivot and time grouping

Request

Version stringrequired

API Version

Available options2021-07-28

locationId stringrequired

Location ID

pivot string

Analytics pivot type

Available optionsACCOUNTCAMPAIGNCAMPAIGN_GROUPCREATIVE

groupBy string

Time granularity for analytics

Available optionsdaymonthyear

startDate stringrequired

Start date in yyyy-mm-dd format

endDate stringrequired

End date in yyyy-mm-dd format

entityUrns string

Comma-separated list of entity URNs

fields string[]

Reporting fields. Pass as comma-separated values on the wire (e.g. ?fields=impressions,clicks).

Available optionsclicksoneClickLeadscostInLocalCurrencyimpressionscostInUsdctrcpccpmcplexternalWebsitePostClickConversionsconversionRate

application/json

Metrics grouped by the requested pivot, plus totals. Only the requested fields appear.

application/json

Schema

Schema

groupedobject[]required

One entry per pivot bucket

totalsobjectrequired

Metrics summed across every bucket

Example (auto)

{
  "grouped": [
    {
      "impressions": 15230,
      "clicks": 214,
      "oneClickLeads": 8,
      "externalWebsitePostClickConversions": 6,
      "ctr": 1.4,
      "cpc": 0.66,
      "cpm": 9.35,
      "cpl": 17.79,
      "conversionRate": 3.74,
      "pivotValues": [
        "urn:li:sponsoredAccount:509444880"
      ],
      "dateStart": "2026-07-01",
      "dateEnd": "2026-07-31",
      "costInUsd": "576.049999999999648674",
      "costInLocalCurrency": "576.05000000000014868"
    }
  ],
  "totals": {
    "impressions": 15230,
    "clicks": 214,
    "oneClickLeads": 8,
    "externalWebsitePostClickConversions": 6,
    "ctr": 1.4,
    "cpc": 0.66,
    "cpm": 9.35,
    "cpl": 17.79,
    "conversionRate": 3.74,
    "costInUsd": 240.45,
    "costInLocalCurrency": 240.45
  }
}