LinkedIn API
Options for posting using the LinkedIn API
JSON for a basic post with a link and image to LinkedIn:
- 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 can not 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 your video 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.
You must be a “Super Admin” or a “Content Admin” to connect a LinkedIn company page.
Video Publishing Permissions
On LinkedIn, only users with specific permissions can publish videos to company pages:
- Users with Admin permissions.
- Users with Direct Sponsored Content (DSC) permissions.
Content Administrators do not have the ability to publish videos to LinkedIn company pages.
Video Thumbnail
Set a thumbnail for a video. Send a remote URL of a PNG or JPG file that is the same dimensions as the video and less than 10 MB. URL should end in .png or .jpg.
Use the thumbNail
in the linkedInOptions
object.
Alternative Text
Add alternative text, also known as alt text, to a LinkedIn image. LinkedIn alt text is an accessibility feature used for additional user info and screen readers. LinkedIn does not support altText on videos or documents.
Use the altText
in the linkedInOptions
object.
Each alt text must correspond to an image in the mediaUrls
array. The alt text will be applied to each image in order.
Titles
Add title or media captions to LinkedIn images or videos.
Use the titles
in the linkedInOptions
object.
Each title must correspond to an image or video in the mediaUrls
array. The title will be applied to each image or video in order.
Multi Image Posts
You may post up to 9 image URLs in the mediaUrls to LinkedIn.
LinkedIn does not yet support carousel images for organic posts.
LinkedIn Mentions
Mention another LinkedIn organization handle by adding @handle
in the post text. The @handle
is the name of the company or organization. You many mention in post, comments, and reply to comments.
For example,
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.
If the @mention is not found, the @ will be removed from the post since LinkedIn will not accept posts with unresolved mentions. Individual LinkedIn profiles can not be mentioned.
Please review the important rules on mentions.
LinkedIn Documents
Use the API to post a document on LinkedIn. Supported file formats include: PPT, PPTX, DOC, DOCX, and PDF. Ensure the document is under 100MB in size and does not exceed 300 pages.
Below is a code sample demonstrating how to post a PPTX document with a title:
The media URL profiled must end in a known document extension: ppt, pptx, doc, docx, or pdf.
LinkedIn Auth Refresh
LinkedIn must be reauthorized every year via the Social Accounts page.
An email and webhook social action notification will be sent 10 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.
Please see here for more examples of using the LinkedIn API.