Share via

Advertising - Overview

  • Article

Warning

Deprecation Notice
The Marketing Version 202310 (Marketing October 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

Advertising API product allows developers to manage LinkedIn’s campaign management platform on behalf of their clients through APIs. The set of APIs offered by this products maps to all the features that are part of the campaign management UI tool. The features includes creation and management of ads account, campaign groups, campaigns, creatives, ad type and analytics.

With the access to the APIs offered by the Advertising API program, developers are able to create and manage their Ad Accounts through the APIs only with no dependency on the campaign manager UI. The API calls to any of the APIs in the Advertising API are successful only if they are called with the correct scopes/permissions that are assigned to the app after going through the vetting process. Once the developer application has the right set of permissions, all the following features of the Advertising Account can be unlocked by passing the identifiers obtained in the response from a level above in the hierarchy.

AdAccounts

LinkedIn enables you to create Ad Accounts for your organization's advertising campaigns. An Ad Account can have a maximum of 5,000 campaigns and 15,000 creatives. To create and manage ad campaigns, you must have an Enterprise or Business Ad Account with one authenticated user assigned as the account administrator.

Account Users

The Ad Account Users API enables advertisers to manage ad account user access. Ad account users are members who have ad account permissions in Campaign Manager. Partners can manage what roles a user has in order to more finely control access.

Campaign Groups

Campaign groups provide advertisers a way to manage status, budget, and performance across multiple related campaigns. Whenever an Ad Account is created, a new campaign group is automatically created for it. A campaign group can contain a variety of campaign types. There is no limit to the number of campaign groups per advertiser account. Note that LinkedIn imposes a limit of 5,000 campaigns per advertiser account and 2,000 campaigns per non-default campaign group.

Campaigns

Campaigns define the ad schedule and budget (daily/total.) The campaign can be bound to a specific start and end date or run continuously until the budget is spent. Campaigns can be targeted for a specific selection of members (target audience) based on categories such as job title, job function, seniority, etc.

Creatives

The Creatives API contains all the data and information for visually rendering an ad. There are several types of Ad Creatives that you can associate with campaigns including:

  • Video Ads
  • Message Ads
  • Jobs Ad
  • Text Ad
  • Image Ad
  • Follower Ads
  • Carousel Ad
  • Article Ad
  • Spotlight Ads
  • Conversation Ads

Analytics

The LinkedIn Reporting APIs provide key insights on performance such as clicks, impressions, and ad spend, and demographics information such as metrics by demographic values at the account, campaign, and creative levels. These insights help your users make the most of their LinkedIn ads experience and ensure that their campaigns are performing effectively.

Video Ads

Video Ads is the next generation of our Sponsored Content products that help you engage business decision-makers on LinkedIn's mobile and desktop news feed.

Message Ads

A Message Ad is a message delivered to a LinkedIn member's InMail inbox.

Jobs Ad

Jobs Ads allow you to personalize ads to top talent, encouraging relevant candidates to apply with your company.

Text Ad

Image Ad

Single Image Ads are Sponsored Content posts that appear in the LinkedIn feed. Deliver your message to a targeted audience beyond your organization's LinkedIn Page with these native ads.

Follower Ad

Follower Ads allow you to promote your LinkedIn Page or Showcase Page and encourage members to follow your LinkedIn Page.

Carousel Ads are a Sponsored Content ad format that allows you to display multiple images in succession in a single, carousel-style format.

Article Ad

Article Ads are Sponsored Content posts that appear in the LinkedIn feed. Deliver your message to a targeted audience beyond your organization's LinkedIn Page with these native ads.

Spotlight Ads

Spotlight Ads allow you to showcase your product, service, event, content, and more. Upon clicking your Ad, you navigate to the website or landing page of your choice.

Conversation Ads

A Conversation Ad is a LinkedIn ad format that allows advertisers to deliver pre-determined messages to an inbox of a targeted LinkedIn member. It provides a chat-like experience between both the member and the advertiser.

Apply for Access

To know more, refer Apply for API Access Documentation.

API product Availability How to Request
Advertising API Vetted Product along with a development and standard tier Use the increasing access link to apply.

Note

Applications must be authorized and authenticated before they can fetch data from LinkedIn or get access to LinkedIn member data. To know more about the OAuth flows, see here.

Postman Collection

Try in Postman

Versioning

LinkedIn’s Marketing API Program supports versioning so API partners can release changes over time. This document explains how to use versioned APIs, see here.

Stay Informed and Get Support

These resources can help you stay on top of new features, migrations, and deprecations: