Share via

Image Ads API

  • 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.

Image ads help you engage business decision-makers on LinkedIn's mobile and desktop news feed. You can create image ads in two ways:

  • Post images to your Company Page and sponsor the post to reach more than just followers. Your organization can share a first-hand look into your company culture, products, news, and events with a company page image to drive further engagement and conversation.
  • Create image ads that bypass Company Page followers and go directly to your news feed.

Permissions

Permission Description
w_organization_social Restricted to organizations in which the authenticated member has one of the following company page roles:
  • ADMINISTRATOR
  • DIRECT_SPONSORED_CONTENT_POSTER
  • CONTENT_ADMIN
    		•
    w_member_social Post, comment, and like posts on behalf of authenticated member.
    rw_ads Create ads and creatives for a sponsored account
    r_ads Read an authenticated member's Ad Account. Restricted to Ad Accounts in which the authenticated member has one of the following Ad Account roles.
  • ACCOUNT_BILLING_ADMIN
  • ACCOUNT_MANAGER
  • CAMPAIGN_MANAGER
  • CREATIVE_MANAGER
  • VIEWER
    		•

    See Account Access Controls for more information on company page roles.

    Note

    There are additional permission checks performed when retrieving or editing an image asset, see Images API Permissions.

    Create Image Ad with a new Image

    1. Create an Image campaign. For more information, see Create a Campaign.
    2. Create a Post using the Image URN in the content field.
    3. Create an Image Creative with the image post. For more information, see creatives.

    Note

    Ensure you include the request header "Content-Type": "application/json"

    POST https://api.linkedin.com/rest/posts

    {
   "adContext": {
       "dscAdAccount": "urn:li:sponsoredAccount:508915158",
       "dscStatus": "ACTIVE"
   },
  "author": "urn:li:organization:5515715",
  "commentary": "Sample Image Post",
  "visibility": "PUBLIC",
  "distribution": {
    "feedDistribution": "NONE",
    "targetEntities": [{
                "geoLocations": [
                    "urn:li:geo:103644278"
                ],
                "seniorities": [
                    "urn:li:seniority:3"
                ]
            }],
    "thirdPartyDistributionChannels": []
  },
  "content":{
    "media":{
      "title":"title of the image",
      "id": "urn:li:image:C5F10AQGKQg_6y2a4sQ"
      }
    },
  "lifecycleState": "PUBLISHED",
  "isReshareDisabledByAuthor": true
}

    A successful response returns a 201 Created HTTP status code and the ID in the x-linkedin-id response header.

    Create an Image Ad with an Inline Post

    You can directly create a sponsored image post that will not show to Company Page followers but will be directly sponsored to target LinkedIn members' news feeds.

    1. Create an Image campaign. For more information, see Create a Campaign.
    2. Create an Image Creative with inlineContent.