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. readonlyAuth methods:
OAuthPrivate IntegrationToken type:
Sub-Account TokenRequest
Headers
Versionstringrequired
API Version
Available options
v3Example:
v3Query Parameters
locationIdstringrequired
Location ID
Example:
loc_abc123pivotstring
Analytics pivot type
Available options
ACCOUNTCAMPAIGNCAMPAIGN_GROUPCREATIVEExample:
ACCOUNTgroupBystring
Time granularity for analytics
Available options
daymonthyearExample:
daystartDatestringrequired
Start date in yyyy-mm-dd format
Example:
2024-01-01endDatestringrequired
End date in yyyy-mm-dd format
Example:
2024-01-31entityUrnsstring
Comma-separated list of entity URNs
Example:
urn:li:sponsoredCampaign:123,urn:li:sponsoredCampaign:456fieldsstring[]
Reporting fields. Pass as comma-separated values on the wire (e.g. ?fields=impressions,clicks).
Available options
clicksoneClickLeadscostInLocalCurrencyimpressionscostInUsdctrcpccpmcplexternalWebsitePostClickConversionsconversionRateExample:
["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