Skip to main content
LinkedIn ReportingVersion: v3New

Get reporting list

GET/ad-publishing/linkedin/reporting/list
deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Retrieve a list of LinkedIn campaigns or campaign groups with reporting data. Deprecated: use GET /ad-publishing/linkedin/reporting/rows with header version: v4.

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
listTypestringrequired

List type

Available optionscampaignGroupscampaignsads
Example:campaigns
campaignIdstringrequired

Campaign ID

Example:12345678
campaignGroupIdstringrequired

Campaign group ID

Example:87654321
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"]

Response

application/json

Metrics per entity for the period. Identity fields vary with listType.

  • Array items
    • 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

    Stored record id, as _id rather than id

    Example:693c9998ce9aa51d56fa2c7a
    namestringrequired

    Entity name

    Example:Q3 demand generation
    publishingStatusstringrequired

    Publishing status

    Example:PAUSED
    adCampaignGroupIdstring

    LinkedIn campaign group id. Present when listType is campaignGroups.

    Example:807183436
    adCampaignIdstring

    Parent ad campaign record id. Present when listType is ads.

    Example:693c99a8682f9414fbd27580
    adIdstring

    LinkedIn creative id. Present when listType is ads.

    Example:994458886
    campaignNamestring

    Name of the parent campaign. Present when listType is ads.

    Example:48 hours leads