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"
]
}
]
}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:clicksLikes Total
The count of likes that your Sponsored Updates received.
li_ads:likesImpressions
Total of impressions for Direct Ads and Sponsored Updates, and the number of "sends" for InMails.
li_ads:impressionsFollowers Gained
Count of people that followed from a Sponsored Update.
li_ads:followsTotal Engagement
The count of all user interactions with the ad unit.
li_ads:total_engagementsShares
The count of shares of your ads. For Sponsored Updates only.
li_ads:sharesTotal Comments
Count of comments made on Sponsored Updates.
li_ads:commentsCost
Total cost of the ads. It is the sum of the campaigns selected, or the whole account, if you chose it.
li_ads:costConversion Rate
Percentage of conversions to clicks (number of total conversions divided by clicks).
li_ads:conversionsRateTotal 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:externalWebsiteConversionsClick Conversions
Total number of clicks on your ads that led to a conversion
li_ads:externalWebsitePostClickConversionsView Conversions
Total number of views on your ads that led to a conversion
li_ads:externalWebsitePostViewConversionsLeads
Number of leads captured by your campaigns, during the selected analysis period.
li_ads:oneClickLeadsCost 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:costPerLeadValue 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:conversionValueInLocalCurrencyCost Per Conversion
Average amount spent on each conversion (total spent divided by conversions).
li_ads:costPerConversionAverage CTR
Average CTR indicates the percentage of chargeable clicks versus impressions (clicks divided by impressions).
li_ads:averageCtrAverage 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:averageCpcAverage 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:averageCpmViews
Plays of two continuous seconds or more while the video is at least 50% of the screen.
li_ads:videoViewsReproductions
The count of video ads that were started by users.
li_ads:videoStartsCPV
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:costPerViewView Rate
View rate of your videos. This metric is calculated by dividing the number of views/impressions, and multiplying by 100.
li_ads:viewRateCampaigns count
Number of page campaigns published by the page.
li_ads:count_campaignsAds count
Number of page ads published by the page.
li_ads:count_adsCard Clicks
The count of clicks on the cards of your ads, for example, clicks to view the landing page or company page.
li_ads:cardClicksAction Clicks
The count of clicks on the action button of the Sponsored Messaging ad.
li_ads:actionClicksAd Unit Clicks
The count of clicks on the ad unit displayed alongside the Sponsored Messaging ad.
li_ads:adUnitClicksApproximate Member Reach
The estimated number of unique member accounts with at least one impression.
li_ads:approximateMemberReachCard Impressions
The count of impressions on the cards of your ads, for example, impressions of the landing page or company page.
li_ads:cardImpressionsComment Likes
The count of likes of a comment. Sponsored Content only.
li_ads:commentLikesCompany Page Clicks
The count of clicks to view the company page.
li_ads:companyPageClicksDocument Completions
The number of times users reached 100% of the document's length.
li_ads:documentCompletionsDocument First Quartile Completions
The number of times users reached the first quartile of the document's length.
li_ads:documentFirstQuartileCompletionsDocument Midpoint Completions
The number of times users reached the second quartile of the document's length.
li_ads:documentMidpointCompletionsDocument Third Quartile Completions
The number of times users reached the third quartile of the document's length.
li_ads:documentThirdQuartileCompletionsDownload Clicks
The number of times users have indicated the intent to download the media in an ad by clicking the download icon.
li_ads:downloadClicksFull Screen Plays
Number of times members click on the full screen button or on the video(mobile only).
li_ads:fullScreenPlaysHeadline Clicks
The number of times members clicked on the headline of conversation ads.
li_ads:headlineClicksHeadline Impressions
The number of times members were shown the headline of conversation ads.
li_ads:headlineImpressionsJob Applications
The number of times a member completed a job application after viewing or clicking on an ad.
li_ads:jobApplicationsJob 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:jobApplyClicksLanding Page Clicks
The count of clicks which take the user to the creative landing page.
li_ads:landingPageClicksLead 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:leadGenerationMailContactInfoSharesLead Generation Mail Interested Clicks
The count of Sponsored Messaging ad recipients who clicked to demonstrate interest.
li_ads:leadGenerationMailInterestedClicksOne Click Lead Form Opens
The count of times users opened the lead form for a One Click Lead Gen campaign.
li_ads:oneClickLeadFormOpensOpens
The count of opens of Sponsored Messaging ads.
li_ads:opensPost Click Job Applications
The number of times a member completed a job application after clicking on an ad.
li_ads:postClickJobApplicationsPost 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:postClickJobApplyClicksPost 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:postClickRegistrationsPost View Job Applications
The number of times a member completed a job application after viewing an ad.
li_ads:postViewJobApplicationsPost 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:postViewJobApplyClicksPost 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:postViewRegistrationsReactions
The count of positive reactions on Sponsored Content which can capture, like, interest, praise, and other responses.
li_ads:reactionsRegistrations
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:registrationsSends
The count of sends of Sponsored Messaging ads.
li_ads:sendsTalent Leads
Number of leads captured through a talent media campaign.
li_ads:talentLeadsText URL Clicks
The count of clicks on any links (anchor tags) that were included in the body of the Sponsored Messaging ad.
li_ads:textUrlClicksVideo Completions
The count of video ads that played 97-100% of the video.
li_ads:videoCompletionsVideo First Quartile Completions
The count of video ads that played through the first quartile of the video.
li_ads:videoFirstQuartileCompletionsVideo Midpoint Completions
The count of video ads that played through the midpoint of the video.
li_ads:videoMidpointCompletionsVideo Third Quartile Completions
The count of video ads that played through the third quartile of the video.
li_ads:videoThirdQuartileCompletionsViral 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:viralCardClicksViral 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:viralCardImpressionsViral Clicks
The count of clicks on viral impressions. Sponsored Content only.
li_ads:viralClicksViral Comment Likes
The count of likes on comments from viral impressions for this activity. Sponsored Content only.
li_ads:viralCommentLikesViral Comments
The count of comments from viral impressions for this activity. Sponsored Content only.
li_ads:viralCommentsViral Company Page Clicks
The count of clicks to view the company page from viral impressions for this activity. Sponsored Content only.
li_ads:viralCompanyPageClicksViral 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:viralDownloadClicksViral External Website Conversions
The count of conversions that are attributed to your ads driven by a viral event.
li_ads:viralExternalWebsiteConversionsViral External Website Post Click Conversions
The count of post-click conversions that are attributed to your ads driven by a viral click.
li_ads:viralExternalWebsitePostClickConversionsViral External Website Post View Conversions
The count of post-view conversions that are attributed to your ads driven by a viral impression.
li_ads:viralExternalWebsitePostViewConversionsViral Follows
The count of follows from viral impressions for this activity. Sponsored Content only.
li_ads:viralFollowsViral 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:viralFullScreenPlaysViral 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:viralImpressionsViral Job Applications
The number of times a member completed a job application after viewing or clicking on a viral ad.
li_ads:viralJobApplicationsViral 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:viralJobApplyClicksViral Landing Page Clicks
The count of clicks on viral impressions to take the user to the creative landing page. Sponsored Content only.
li_ads:viralLandingPageClicksViral Likes
The count of likes from viral impressions for this activity. Sponsored Content only.
li_ads:viralLikesViral Reactions
The count of positive reactions on viral Sponsored Content which can capture like, interest, praise, and other responses.
li_ads:viralReactionsViral 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:viralRegistrationsViral Shares
The count of shares from viral impressions for this activity. Sponsored Content only.
li_ads:viralSharesViral Engagements
The count of all user interactions with a viral ad unit. Sponsored Content only.
li_ads:viralTotalEngagementsViral 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:viralVideoViewsOpen Rate
Total number of opened messages divided by total number of sent messages
li_ads:opensRateClick-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:clicksPerOpensRateCost per sent
Total spend divided by total deliveries, which is the total number of times the ad was shown.
li_ads:costPerSendsCost 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_dayImpressions 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:postsFeatured campaigns
Campaigns that had the biggest impact on your audience during the period analyzed.
li_ads:featuredCampaignsSponsored Message Campaigns
Performance summary of your Sponsored Messages campaigns over the analyzed period.
li_ads:featuredSponsoredMessagingFeatured campaign groups
Campaign groups that had the biggest impact on your audience during the period analyzed.
li_ads:featuredCampaignGroupsPerformance by Company Size
Campaign results for the period analyzed according to the size of the companies of the impacted users.
li_ads:performanceCompanySizePerformance by Seniority Level
Results of campaigns for the period analyzed according to the Seniority Level of impacted users.
li_ads:performanceSenioritiesPerformance by Job Title
Results of campaigns for the period analyzed according to the Job Title of impacted users.
li_ads:performanceTitlesPerformance by Industry Sector
Results of campaigns for the period analyzed according to the Industry Sector of impacted users.
li_ads:performanceIndustriesPerformance by Job Function
Results of the campaigns for the period analyzed according to the Job Function of the impacted users.
li_ads:performanceFunctionsPerformance by Region
Results of campaigns for the period analyzed according to the Region of impacted Members.
li_ads:performanceRegionPerformance by Country
Results of campaigns for the period analyzed according to the country of impacted Members.
li_ads:performanceCountriesPerformance by Companies
Results of campaigns for the period analyzed according to the Company of the impacted Members.
li_ads:performanceCompaniesConversions 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.
