Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt

Use this file to discover all available pages before exploring further.

Coming soon Coming soon. LinkedIn Organization Page comment management and publishing is in active development via the LinkedIn Marketing Developer Platform. When it launches, SocialAPI will handle the LinkedIn App and platform app review for you. No customer-side LinkedIn Developer registration will be required. See Platform credentials.

​
At a glance

FieldValue
Platform sluglinkedin
Auth typeOAuth 2.0 (LinkedIn)
APILinkedIn Marketing Developer Platform
Best forB2B reach: company-page posts and comment moderation on LinkedIn.

​
Capabilities

FeatureSupportedNotes
List postsComing soonProfile and page posts
CommentsComing soonScoped to a specific post
Reply to commentComing soon
Comment replies (thread)Coming soon
Moderate commentComing soonDelete only at launch; hide/unhide not supported by LinkedIn API
Toggle post commentsComing soon
DMsNoNot supported by LinkedIn API
ReviewsNoNot applicable
MentionsNoNot supported via LinkedIn API
Create postComing soonText, images, articles
Update postComing soonText only, media cannot be updated
Delete postComing soon

​
Connecting

curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "linkedin",
    "metadata": {
      "redirect_uri": "https://app.example.com/oauth/callback"
    }
  }'
Response: 
{
  "auth_url": "https://www.linkedin.com/oauth/v2/authorization?client_id=...&state=...",
  "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2"
}
Redirect your user to auth_url. After they authorize, LinkedIn redirects to your redirect_uri with ?code=...&state=.... Then call: 
curl -X POST https://api.social-api.ai/v1/oauth/exchange \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "linkedin",
    "code": "AQR1234...",
    "metadata": {
      "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2",
      "redirect_uri": "https://app.example.com/oauth/callback"
    }
  }'

​
Reading samples

​
List posts

curl "https://api.social-api.ai/v1/accounts/{id}/posts?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

​
List comments on a post

curl "https://api.social-api.ai/v1/accounts/{id}/posts/{post_id}/comments?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

​
Publishing

For the full field reference, media constraints, and error recovery, see Publishing to LinkedIn.

​
Limitations and gotchas

  • Moderation: LinkedIn only supports deleting comments. Hide and unhide actions return 501.
  • Post updates: Only the text content of a post can be updated. Media attachments cannot be changed after publishing.
  • Toggle comments: You can enable or disable comments on posts you own.
  • Token refresh: LinkedIn OAuth tokens expire after 60 days. SocialAPI handles refresh automatically. If you receive 401 with code: "invalid_token", reconnect the account.

​
Permissions

SocialAPI’s managed LinkedIn Developer app already requests these scopes on your behalf: r_liteprofile, rw_organization_admin, r_organization_social, w_organization_social. You don’t need to register with LinkedIn Developers. See Platform credentials.