Skip to main content
LinkedIn ReportingVersion: v3

Get ad analytics

GET/ad-publishing/linkedin/reporting

Retrieve LinkedIn Ads analytics data with configurable pivot and time grouping

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location ID

Example:loc_abc123
pivotstring

Analytics pivot type

Available optionsACCOUNTCAMPAIGNCAMPAIGN_GROUPCREATIVE
Example:ACCOUNT
groupBystring

Time granularity for analytics

Available optionsdaymonthyear
Example:day
startDatestringrequired

Start date in yyyy-mm-dd format

Example:2024-01-01
endDatestringrequired

End date in yyyy-mm-dd format

Example:2024-01-31
entityUrnsstring

Comma-separated list of entity URNs

Example:urn:li:sponsoredCampaign:123,urn:li:sponsoredCampaign:456
fieldsstring[]

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

Available optionsclicksoneClickLeadscostInLocalCurrencyimpressionscostInUsdctrcpccpmcplexternalWebsitePostClickConversionsconversionRate
Example:["impressions","clicks","costInUsd"]

Response

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

groupedobject[]required

One entry per pivot bucket

totalsobjectrequired

Metrics summed across every bucket