Skip to main content
LinkedIn ReportingVersion: v3

Get campaign group reporting

GET/ad-publishing/linkedin/reporting/campaign-group/{campaignGroupId}

Retrieve reporting metrics for a specific LinkedIn campaign group

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

Path Parameters

campaignGroupIdstringrequired

Campaign group identifier

Example:12345678

Query Parameters

locationIdstringrequired

Location ID

Example:loc_abc123
startDatestringrequired

Start date in yyyy-mm-dd format

Example:2024-01-01
endDatestringrequired

End date in yyyy-mm-dd format

Example:2024-01-31
fieldsstring[]

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

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

Campaign group ID

Example:87654321

Response

application/json

Metrics for the campaign group over the period, merged with the stored campaign group

impressionsnumber

Impressions

Example:15230
clicksnumber

Clicks

Example:214
oneClickLeadsnumber

Leads captured through a one-click lead form

Example:8
externalWebsitePostClickConversionsnumber

Conversions recorded on an external site after a click

Example:6
ctrnumbernullable

Click-through rate as a percentage, e.g. 1.40 means 1.40%. Null when it cannot be computed.

Example:1.4
cpcnumbernullable

Cost per click in the account currency. Null when it cannot be computed.

Example:0.66
cpmnumbernullable

Cost per thousand impressions. Null when it cannot be computed.

Example:9.35
cplnumbernullable

Cost per lead. Null when it cannot be computed.

Example:17.79
conversionRatenumbernullable

Conversion rate as a percentage. Null when it cannot be computed.

Example:3.74
pivotValuesstring[]required

URNs of the entity this row is pivoted on — a sponsored account, campaign group or creative depending on the request. This is not the time bucket; that is carried by dateStart/dateEnd.

Example:["urn:li:sponsoredAccount:509444880"]
dateStartstringrequired

First day covered by the row

Example:2026-07-01
dateEndstringrequired

Last day covered by the row

Example:2026-07-31
costInUsdstring

Spend in USD. Returned as a string on grouped rows, unlike in totals, and at full source precision — e.g. 899.99999999999988713. Parse as a decimal rather than a float.

Example:576.049999999999648674
costInLocalCurrencystring

Spend in the account currency. Returned as a string on grouped rows, unlike in totals, and at full source precision. Parse as a decimal rather than a float.

Example:576.05000000000014868
_idstringrequired

Campaign group record id, as _id rather than id

Example:693c9998ce9aa51d56fa2c7a
__vnumberrequired

Mongoose internal version key

Example:0
namestringrequired

Campaign group name

Example:Q3 demand generation
locationIdstringrequired

Location identifier

Example:ASYI07d4Xt8ifUCwVZyT
linkedInAdAccountIdstringrequired

LinkedIn ad account id

Example:509444880
publishingStatusstringrequired

Publishing status

Example:PAUSED
objectiveTypestringrequired

Campaign objective

Available optionsLEAD_GENERATIONWEBSITE_VISIT
Example:LEAD_GENERATION
adBudgetOptimizationstring

Budget optimisation mode

Available optionsMAXIMUM_DELIVERYCOST_CAP
Example:MAXIMUM_DELIVERY
budgetobjectrequired

Budget configuration

adCampaignGroupIdstring

LinkedIn campaign group id, set once published

Example:807183436
linkedInErrorstringrequired

Publish or review error. Empty string when there is none.

Example:
createdAtstringrequired

Created at

Example:2025-12-12T22:39:20.263Z
updatedAtstringrequired

Updated at

Example:2026-01-12T15:13:52.592Z