Metrics

LinkedIn Ads metrics via API

Your customer connects their LinkedIn Ads account and your product queries 103 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:clicks",
      "component": "number_v1",
      "metrics": [
        "clicks"
      ]
    }
  ]
}
Example: "Clicks" in October, compared to September.

More LinkedIn Ads request examples

The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).

Chart

Clicks Evolution

This graph displays the number clicks during the selected period.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:clicks_by_day",
      "component": "chart_v1",
      "metrics": [
        "clicks"
      ],
      "dimensions": [
        "dateRange"
      ]
    }
  ]
}

Table

Ads

These are the ads that had the most impact on your audience, sorted by impressions. For Sponsored Updates only.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:posts",
      "component": "datatable_v1",
      "metrics": [
        "costInLocalCurrency",
        "impressions",
        "clicks",
        "totalEngagements",
        "createdAt"
      ],
      "dimensions": [
        "posts"
      ]
    }
  ]
}

Number

Likes Total

The count of likes that your Sponsored Updates received.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:likes",
      "component": "number_v1",
      "metrics": [
        "likes"
      ]
    }
  ]
}

Numbers

88 metrics

  • Clicks

    The count of clicks on your ads, for example, clicks to view the landing page or company page.

    li_ads:clicks
  • Likes Total

    The count of likes that your Sponsored Updates received.

    li_ads:likes
  • Impressions

    Total of impressions for Direct Ads and Sponsored Updates, and the number of "sends" for InMails.

    li_ads:impressions
  • Followers Gained

    Count of people that followed from a Sponsored Update.

    li_ads:follows
  • Total Engagement

    The count of all user interactions with the ad unit.

    li_ads:total_engagements
  • Shares

    The count of shares of your ads. For Sponsored Updates only.

    li_ads:shares
  • Total Comments

    Count of comments made on Sponsored Updates.

    li_ads:comments
  • Cost

    Total cost of the ads. It is the sum of the campaigns selected, or the whole account, if you chose it.

    li_ads:cost
  • Conversion Rate

    Percentage of conversions to clicks (number of total conversions divided by clicks).

    li_ads:conversionsRate
  • Total Conversions

    Total number of times people took a desired action after clicking or viewing your ad. When conversions cannot be attributed to individual members, group-level attribution or estimation can be used.

    li_ads:externalWebsiteConversions
  • Click Conversions

    Total number of clicks on your ads that led to a conversion

    li_ads:externalWebsitePostClickConversions
  • View Conversions

    Total number of views on your ads that led to a conversion

    li_ads:externalWebsitePostViewConversions
  • Leads

    Number of leads captured by your campaigns, during the selected analysis period.

    li_ads:oneClickLeads
  • Cost per lead

    The average cost of each lead captured. This metric is calculated by dividing the total amount spent by the number of leads.

    li_ads:costPerLead
  • Value of conversions

    Total value generated by your conversions (value per conversion multiplied by number of conversions). The value can be set when creating conversions and should reflect how much you value each conversion.

    li_ads:conversionValueInLocalCurrency
  • Cost Per Conversion

    Average amount spent on each conversion (total spent divided by conversions).

    li_ads:costPerConversion
  • Average CTR

    Average CTR indicates the percentage of chargeable clicks versus impressions (clicks divided by impressions).

    li_ads:averageCtr
  • Average CPC

    Cost Per Click (CPC) shows you how much, on average, each link click costs you. It's calculated by dividing the total spent on your ads by the total clicks.

    li_ads:averageCpc
  • Average CPM

    CPM is the average price of 1000 impressions. It's calculated by dividing the total spent on your ads by the amount of total clicks.

    li_ads:averageCpm
  • Views

    Plays of two continuous seconds or more while the video is at least 50% of the screen.

    li_ads:videoViews
  • Reproductions

    The count of video ads that were started by users.

    li_ads:videoStarts
  • CPV

    Average cost of viewing your video ads. While some video views may be free as a result of organic reach from users sharing your ad, only paid views are included in CPV.

    li_ads:costPerView
  • View Rate

    View rate of your videos. This metric is calculated by dividing the number of views/impressions, and multiplying by 100.

    li_ads:viewRate
  • Campaigns count

    Number of page campaigns published by the page.

    li_ads:count_campaigns
  • Ads count

    Number of page ads published by the page.

    li_ads:count_ads
  • Card Clicks

    The count of clicks on the cards of your ads, for example, clicks to view the landing page or company page.

    li_ads:cardClicks
  • Action Clicks

    The count of clicks on the action button of the Sponsored Messaging ad.

    li_ads:actionClicks
  • Ad Unit Clicks

    The count of clicks on the ad unit displayed alongside the Sponsored Messaging ad.

    li_ads:adUnitClicks
  • Approximate Member Reach

    The estimated number of unique member accounts with at least one impression.

    li_ads:approximateMemberReach
  • Card Impressions

    The count of impressions on the cards of your ads, for example, impressions of the landing page or company page.

    li_ads:cardImpressions
  • Comment Likes

    The count of likes of a comment. Sponsored Content only.

    li_ads:commentLikes
  • Company Page Clicks

    The count of clicks to view the company page.

    li_ads:companyPageClicks
  • Document Completions

    The number of times users reached 100% of the document's length.

    li_ads:documentCompletions
  • Document First Quartile Completions

    The number of times users reached the first quartile of the document's length.

    li_ads:documentFirstQuartileCompletions
  • Document Midpoint Completions

    The number of times users reached the second quartile of the document's length.

    li_ads:documentMidpointCompletions
  • Document Third Quartile Completions

    The number of times users reached the third quartile of the document's length.

    li_ads:documentThirdQuartileCompletions
  • Download Clicks

    The number of times users have indicated the intent to download the media in an ad by clicking the download icon.

    li_ads:downloadClicks
  • Full Screen Plays

    Number of times members click on the full screen button or on the video(mobile only).

    li_ads:fullScreenPlays
  • Headline Clicks

    The number of times members clicked on the headline of conversation ads.

    li_ads:headlineClicks
  • Headline Impressions

    The number of times members were shown the headline of conversation ads.

    li_ads:headlineImpressions
  • Job Applications

    The number of times a member completed a job application after viewing or clicking on an ad.

    li_ads:jobApplications
  • Job Apply Clicks

    The number of times a member clicked on the job's apply button on an LinkedIn jobs page after viewing or clicking on a landing page.

    li_ads:jobApplyClicks
  • Landing Page Clicks

    The count of clicks which take the user to the creative landing page.

    li_ads:landingPageClicks
  • Lead Generation Mail Contact Info Shares

    The number of times users shared contact info through the One Click Lead Gen for Sponsored Messaging ad.

    li_ads:leadGenerationMailContactInfoShares
  • Lead Generation Mail Interested Clicks

    The count of Sponsored Messaging ad recipients who clicked to demonstrate interest.

    li_ads:leadGenerationMailInterestedClicks
  • One Click Lead Form Opens

    The count of times users opened the lead form for a One Click Lead Gen campaign.

    li_ads:oneClickLeadFormOpens
  • Opens

    The count of opens of Sponsored Messaging ads.

    li_ads:opens
  • Post Click Job Applications

    The number of times a member completed a job application after clicking on an ad.

    li_ads:postClickJobApplications
  • Post Click Job Apply Clicks

    The number of times a member clicked on the job's apply button on an LinkedIn jobs page after clicking on an ad which has a LinkedIn job landing page.

    li_ads:postClickJobApplyClicks
  • Post Click Registrations

    The number of times a member has registered for an event or seminar after clicking on an ad which has a LinkedIn landing page.

    li_ads:postClickRegistrations
  • Post View Job Applications

    The number of times a member completed a job application after viewing an ad.

    li_ads:postViewJobApplications
  • Post View Job Apply Clicks

    The number of times a member clicked on the job's apply button on an LinkedIn jobs page after clicking an ad which has a LinkedIn job landing page.

    li_ads:postViewJobApplyClicks
  • Post View Registrations

    The number of times a member has registered for an event or seminar after viewing an ad which has a LinkedIn event landing page.

    li_ads:postViewRegistrations
  • Reactions

    The count of positive reactions on Sponsored Content which can capture, like, interest, praise, and other responses.

    li_ads:reactions
  • Registrations

    The number of times a member has registered for an event or seminar after viewing or clicking on an ad which has a LinkedIn event landing page.

    li_ads:registrations
  • Sends

    The count of sends of Sponsored Messaging ads.

    li_ads:sends
  • Talent Leads

    Number of leads captured through a talent media campaign.

    li_ads:talentLeads
  • Text URL Clicks

    The count of clicks on any links (anchor tags) that were included in the body of the Sponsored Messaging ad.

    li_ads:textUrlClicks
  • Video Completions

    The count of video ads that played 97-100% of the video.

    li_ads:videoCompletions
  • Video First Quartile Completions

    The count of video ads that played through the first quartile of the video.

    li_ads:videoFirstQuartileCompletions
  • Video Midpoint Completions

    The count of video ads that played through the midpoint of the video.

    li_ads:videoMidpointCompletions
  • Video Third Quartile Completions

    The count of video ads that played through the third quartile of the video.

    li_ads:videoThirdQuartileCompletions
  • Viral Card Clicks

    The number of "viral clicks" for each card of a carousel ad. The first "viral card clicks" of the carousel ad results in an immediate "viral card clicks" and "viral clicks", whereas scrolling to other cards and clicking will count as additional "viral card clicks".

    li_ads:viralCardClicks
  • Viral Card Impressions

    The number of "viral impressions" shown for each card of a carousel ad. The first card of the carousel ad results in an immediate "viral card impressions" and "viral impressions", whereas scrolling to other cards will count as additional "viral card impressions".

    li_ads:viralCardImpressions
  • Viral Clicks

    The count of clicks on viral impressions. Sponsored Content only.

    li_ads:viralClicks
  • Viral Comment Likes

    The count of likes on comments from viral impressions for this activity. Sponsored Content only.

    li_ads:viralCommentLikes
  • Viral Comments

    The count of comments from viral impressions for this activity. Sponsored Content only.

    li_ads:viralComments
  • Viral Company Page Clicks

    The count of clicks to view the company page from viral impressions for this activity. Sponsored Content only.

    li_ads:viralCompanyPageClicks
  • Viral Download Clicks

    The number of times users have indicated the intent to download the media in a viral ad by clicking the download icon.

    li_ads:viralDownloadClicks
  • Viral External Website Conversions

    The count of conversions that are attributed to your ads driven by a viral event.

    li_ads:viralExternalWebsiteConversions
  • Viral External Website Post Click Conversions

    The count of post-click conversions that are attributed to your ads driven by a viral click.

    li_ads:viralExternalWebsitePostClickConversions
  • Viral External Website Post View Conversions

    The count of post-view conversions that are attributed to your ads driven by a viral impression.

    li_ads:viralExternalWebsitePostViewConversions
  • Viral Follows

    The count of follows from viral impressions for this activity. Sponsored Content only.

    li_ads:viralFollows
  • Viral Full Screen Plays

    Number of times members click on the full screen button or on the video(mobile only) to go into full screen mode.

    li_ads:viralFullScreenPlays
  • Viral Impressions

    The count of viral impressions for this activity. Viral impressions are those resulting from users sharing sponsored content to their own network of connections. Viral impressions are not counted as regular impressions. Sponsored Content only.

    li_ads:viralImpressions
  • Viral Job Applications

    The number of times a member completed a job application after viewing or clicking on a viral ad.

    li_ads:viralJobApplications
  • Viral Job Apply Clicks

    The number of times a member clicked on the job's apply button on an LinkedIn jobs page after viewing or clicking on a viral ad which has a LinkedIn job landing page during the date range.

    li_ads:viralJobApplyClicks
  • Viral Landing Page Clicks

    The count of clicks on viral impressions to take the user to the creative landing page. Sponsored Content only.

    li_ads:viralLandingPageClicks
  • Viral Likes

    The count of likes from viral impressions for this activity. Sponsored Content only.

    li_ads:viralLikes
  • Viral Reactions

    The count of positive reactions on viral Sponsored Content which can capture like, interest, praise, and other responses.

    li_ads:viralReactions
  • Viral Registrations

    The number of times a member has registered for an event or seminar after viewing or clicking on a viral ad which has a LinkedIn event landing page.

    li_ads:viralRegistrations
  • Viral Shares

    The count of shares from viral impressions for this activity. Sponsored Content only.

    li_ads:viralShares
  • Viral Engagements

    The count of all user interactions with a viral ad unit. Sponsored Content only.

    li_ads:viralTotalEngagements
  • Viral Video Views

    A viral video ad playing for at least 2 continuous seconds 50% in-view, or a click on the CTA, whichever comes first. An interaction with the video (like going to full screen mode) does not count as a view.

    li_ads:viralVideoViews
  • Open Rate

    Total number of opened messages divided by total number of sent messages

    li_ads:opensRate
  • Click-through rate per opening

    Percentage of people who clicked after opening your Sponsored Messaging ad (number of clicks divided by number of opens)

    li_ads:clicksPerOpensRate
  • Cost per sent

    Total spend divided by total deliveries, which is the total number of times the ad was shown.

    li_ads:costPerSends
  • Cost per open message

    Total invested divided by total openings.

    li_ads:costPerOpenMessage

Charts

2 metrics

  • Clicks Evolution

    This graph displays the number clicks during the selected period.

    li_ads:clicks_by_day
  • Impressions Evolution

    This graph displays the number impressions during the selected period.

    li_ads:impressions_by_day

Tables

13 metrics

  • Ads

    These are the ads that had the most impact on your audience, sorted by impressions. For Sponsored Updates only.

    li_ads:posts
  • Featured campaigns

    Campaigns that had the biggest impact on your audience during the period analyzed.

    li_ads:featuredCampaigns
  • Sponsored Message Campaigns

    Performance summary of your Sponsored Messages campaigns over the analyzed period.

    li_ads:featuredSponsoredMessaging
  • Featured campaign groups

    Campaign groups that had the biggest impact on your audience during the period analyzed.

    li_ads:featuredCampaignGroups
  • Performance by Company Size

    Campaign results for the period analyzed according to the size of the companies of the impacted users.

    li_ads:performanceCompanySize
  • Performance by Seniority Level

    Results of campaigns for the period analyzed according to the Seniority Level of impacted users.

    li_ads:performanceSeniorities
  • Performance by Job Title

    Results of campaigns for the period analyzed according to the Job Title of impacted users.

    li_ads:performanceTitles
  • Performance by Industry Sector

    Results of campaigns for the period analyzed according to the Industry Sector of impacted users.

    li_ads:performanceIndustries
  • Performance by Job Function

    Results of the campaigns for the period analyzed according to the Job Function of the impacted users.

    li_ads:performanceFunctions
  • Performance by Region

    Results of campaigns for the period analyzed according to the Region of impacted Members.

    li_ads:performanceRegion
  • Performance by Country

    Results of campaigns for the period analyzed according to the country of impacted Members.

    li_ads:performanceCountries
  • Performance by Companies

    Results of campaigns for the period analyzed according to the Company of the impacted Members.

    li_ads:performanceCompanies
  • Conversions performance

    Conversions performance for the period analyzed according to the conversion type.

    li_ads:performanceConversion

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.