LinkedIn API

• The post field accepts up to 3,000 characters.
• LinkedIn will automatically preview the link in the post unless there is an image or video included. In the above example the image will show. Removing the image will cause the link preview to show. If the link preview cannot be retrieved, the post will still be published and a linkPreviewFailed: true field will be returned in the /post response.
• Hashtags are clickable in LinkedIn. Use the # symbol to specify a LinkedIn hashtag.
• If publishing a video and doesn’t end in a known video extension such as mp4, please use the isVideo parameter. See the /post endpoint for details.
• LinkedIn video processing takes several minutes to complete. Please wait before trying the share URL or getting video analytics.
• LinkedIn limits 150 posts per day per LinkedIn account.
• Posting to LinkedIn Groups is not supported.
• LinkedIn also supports sending media without post text. If you do not want post text included send an empty String post: "".
• You may link either a company page or a personal LinkedIn account.
• See LinkedIn Media Guidelines and LinkedIn Authorization for more information.

​

Posting to LinkedIn

{
  "post": "The best LinkedIn post ever #best https://www.linkedin.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["linkedin"]
}

• altText: The alternative text of the post. See LinkedIn Alt Text for more information.
• visibility: The visibility of the post. Default is “public”. See LinkedIn Post Visibility for more information.
• thumbNail: The thumbnail of a video. See LinkedIn Thumbnail for more information.
• titles: Title or media captions to LinkedIn images or videos. See LinkedIn Media Titles for more information.
• title: The title of a document. Maximum length: 400 characters. See LinkedIn Documents for more information.
• targeting: The targeting of the post. See LinkedIn Audience Targeting for more information.

{
  "linkedInOptions": {
    "visibility": "public",
    "altText": ["This is my best pic", "😃 here is the next one"],
    "titles": ["This is an amazing video", "😃 here is the next one"],
    "title": "Sample PPTX",
    "thumbNail": "https://example.com/thumbnail.jpg",
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"]
    }
  }
}

​

Video Publishing Permissions

1. Users with Admin permissions.
2. Users with Direct Sponsored Content (DSC) permissions.

​

Video Thumbnail

{
  "linkedInOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}

​

Alternative Text

{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}

​

Media Titles

{
  "linkedInOptions": {
    "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts
  }
}

​

Multi Image Posts

{
  "mediaUrls": ["https://url1", ..., "https://url9"]
}

​

LinkedIn Mentions

​

Organization Profiles

• Ayrshare’s LinkedIn company profile is https://www.linkedin.com/company/ayrshare and the handle used would be @ayrshare.
• Zara’s LinkedIn company profile is https://www.linkedin.com/company/zara-sa/ and the handle used would be @zara-sa.

{
  "post": "The best social media API @ayrshare ever!",
  "platforms": ["linkedin"]
}

​

Member Profiles

1. @vanity_name is the vanity name of the member profile. For example in the member’s profile URL https://www.linkedin.com/in/vanity_name/, the vanity name is vanity_name.
2. @[John Smith] is the person’s full name. For example if the person’s full name is John Smith, the mention would be @[John Smith].

{
  "post": "The best social media API @[John Smith] and @ava_smith ever!",
  "platforms": ["linkedin"]
}

1. You must have a LinkedIn company page connected to your Ayrshare account to mention member profiles. If you connect your own personal LinkedIn account, you will not be able to mention other people’s profiles.
2. LinkedIn only allows mentioning people who follow your organization / company page.

​

Documents

{
  "post": "What a great document",
  "platforms": ["linkedin"],
  "linkedInOptions": {
    "title": "Sample PPTX" // optional. If not specified, the file name used.
  },
  "mediaUrls": ["https://scholar.harvard.edu/files/torman_personal/files/samplepptx.pptx"]
}

​

Audience Targeting

{
  "linkedInOptions": {
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"],
      "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"],
      "industries": ["Telecommunications Carriers", "Banking"],
      "jobFunctions": ["Information Technology", "Entrepreneurship"],
      "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"]
    }
  }
}

• LinkedIn Countries
• LinkedIn Seniorities
• LinkedIn Degrees
• LinkedIn Fields of Study
• LinkedIn Industries
• LinkedIn Job Functions
• LinkedIn Staff Count Ranges

​

Post Visibility

• public: The post will be visible to all LinkedIn users. Available for both company pages and personal LinkedIn connected accounts. Default if no visibility is specified.
• connections: The post will be visible to the 1st degree network of the owner (user profile). Available for personal LinkedIn connected accounts only.
• loggedin: The post will be visible to logged in LinkedIn users only. Available for both company pages and personal LinkedIn connected accounts.

{
  "linkedInOptions": {
    "visibility": "public" // "public", "connections", or "loggedin"
  }
}

​

Character Limits

​

Authorization Refresh

• An email and webhook social action notification will be sent 15 days in advance of authorization expiration.
• The refresh required date and remaining days can be retrieved from the /user endpoint.
• The user will see on their social account linkage page an alert and a refresh button 30 days prior to expiration.