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.
| Connection | OAuth 2.0 in the browser |
|---|---|
| Channel | Optional: pick a channel after connecting |
| Post types | post |
| Text length | 3,000 characters |
| Comment length | 1,250 characters |
| Media per post | Up to 20 |
Media rules
| Kind | Formats | Max size | Duration | Other |
|---|---|---|---|---|
| Image | jpeg, png, gif | 20 MB | n/a | None |
| Video | mp4 | 500 MB | 3 s to 30 min | None |
| Document | pdf, vnd.ms-powerpoint, vnd.openxmlformats-officedocument.presentationml.presentation, msword, vnd.openxmlformats-officedocument.wordprocessingml.document | 100 MB | n/a | None |
What Siar can do on LinkedIn
| Comments and replies | Yes |
|---|---|
| First comment | Yes |
| Edit a published post | Yes |
| Delete a published post | Yes |
| Edit a comment | Yes |
| Delete a comment | Yes |
| Import comments | Yes |
| Post analytics | Yes |
| Account analytics | Yes |
| Post history import | Yes |
| Direct messages | No |
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
-
textstring required -
uploadIdsstring[] nullable -
linkstring nullable -
thumbnailstring nullable -
mediaTitlestring nullable -
privacystring nullableOne of:CONNECTIONSPUBLICLOGGED_INCONTAINER -
hideFromFeedboolean nullable default false -
disableReshareboolean nullable default false
Daily caps
| Per connected account, per UTC day | Free | Pro | Business |
|---|---|---|---|
| Posts | 10 | 18 | 24 |
| Comments | 3 | 18 | 24 |
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:
openidprofileemailw_member_socialr_member_postAnalyticsr_organization_socialw_organization_socialrw_organization_admin
LinkedIn-specific operations
These exist for LinkedIn only and live under /misc/linkedin.
| Operation | Endpoint |
|---|---|
| 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 post | POST /misc/linkedin/post/reshare |
| Edit an existing LinkedIn post | PATCH /misc/linkedin/post |
| Delete a LinkedIn post | DELETE /misc/linkedin/post |
| Edit an existing LinkedIn comment | PATCH /misc/linkedin/comment |
| Delete a LinkedIn comment | DELETE /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.