NetworksLinkedIn

LinkedIn APIthrough Siar.

Posts to a LinkedIn member profile or a company page, with text, images, video, documents and links.

At a glance

Account needed: A LinkedIn member profile, or a company page the member administers.

ConnectionOAuth 2.0 in the browser
ChannelOptional: pick a channel after connecting
Post typespost
Text length3,000 characters
Comment length1,250 characters
Media per postUp to 20

Media rules

KindFormatsMax sizeDurationOther
Imagejpeg, png, gif20 MBn/aNone
Videomp4500 MB3 s to 30 minNone
Documentpdf, vnd.ms-powerpoint, vnd.openxmlformats-officedocument.presentationml.presentation, msword, vnd.openxmlformats-officedocument.wordprocessingml.document100 MBn/aNone

What Siar can do on LinkedIn

Comments and repliesYes
First commentYes
Edit a published postYes
Delete a published postYes
Edit a commentYes
Delete a commentYes
Import commentsYes
Post analyticsYes
Account analyticsYes
Post history importYes
Direct messagesNo

Siar can create comments and replies up to 1,250 characters, and import the comments people leave on your posts.

Publish a post

Put LinkedIn's payload under data.LINKEDIN and list LINKEDIN in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "LinkedIn post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "LINKEDIN"
    ],
    "data": {
      "LINKEDIN": {
        "text": "Hello from Siar"
      }
    }
  }'

LinkedIn fields

  • text string required
  • uploadIds string[] nullable
  • link string nullable
  • thumbnail string nullable
  • mediaTitle string nullable
  • privacy string nullable
    One of: CONNECTIONS PUBLIC LOGGED_IN CONTAINER
  • hideFromFeed boolean nullable default false
  • disableReshare boolean nullable default false

Daily caps

Per connected account, per UTC dayFreeProBusiness
Posts101824
Comments31824

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting a LinkedIn account

Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

  • openid
  • profile
  • email
  • w_member_social
  • r_member_postAnalytics
  • r_organization_social
  • w_organization_social
  • rw_organization_admin

LinkedIn-specific operations

These exist for LinkedIn only and live under /misc/linkedin.

OperationEndpoint
Get Linkedin mentionable tags (people & organizations)GET /misc/linkedin/mentions/tags
Build Linkedin text, insert mentions at tag placeholders.POST /misc/linkedin/mentions/builder
Reshare an existing LinkedIn postPOST /misc/linkedin/post/reshare
Edit an existing LinkedIn postPATCH /misc/linkedin/post
Delete a LinkedIn postDELETE /misc/linkedin/post
Edit an existing LinkedIn commentPATCH /misc/linkedin/comment
Delete a LinkedIn commentDELETE /misc/linkedin/comment

When LinkedIn says no

Siar relays LinkedIn's error code and message verbatim on the post, next to a status you can act on. The LinkedIn error reference covers 10 common cases with what each one means and the fix. Open the LinkedIn error reference.

LinkedIn API questions

What can I post to LinkedIn through the API?

post. Posts to a LinkedIn member profile or a company page, with text, images, video, documents and links.

How many LinkedIn posts can I publish per day?

Per connected account and UTC day: 10 on Free, 18 on Pro, 24 on Business. The caps keep the account within what LinkedIn tolerates.

Can I schedule LinkedIn posts?

Yes. Set postDate in the future and a status of SCHEDULED. Siar publishes at that time and sends a post.published webhook when the post reaches a final state.

How do I connect a LinkedIn account?

A LinkedIn member profile, or a company page the member administers. Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire.

What do I do when LinkedIn rejects a post?

The post carries LinkedIn's own code and message. The LinkedIn error reference explains 10 common rejections and how to fix them.

Your first post isone request away.

The Free plan includes 20 posts and 200 uploads a month across 3 teams. No card needed.