Manage LinkedIn Company Pages you administer through the Community Management API. Publish Page posts with text, an article link, or up to 20 images; list, read, and delete Page posts; read comments and reply as the Page; and pull organic impressions, clicks, and engagement. Requires a LinkedIn app approved for the Community Management API.
Publish an organic post on a LinkedIn Company Page: text only, text with an article link, or text with 1–20 images uploaded through the Images API
| Parameter | Type | Required | Description |
|---|
organization | string | Yes | Organization ID or URN of the Page to post as (urn:li:organization:{id}) |
text | string | Yes | Post text (max 3000 characters) |
textFormat | string | No | plain (default) escapes LinkedIn's reserved little-text characters so the text appears as written, keeping #hashtags; little sends the text as-is so @[Name](urn) mentions work |
visibility | string | No | PUBLIC (default) or LOGGED_IN (signed-in members only) |
feedDistribution | string | No | MAIN_FEED (default) or NONE to keep the post out of the feed |
disableReshare | boolean | No | Prevent members from resharing the post |
articleUrl | string | No | Link to share as an article card. LinkedIn does not scrape it, so set a title |
articleTitle | string | No | Article card title (required with an article URL) |
articleDescription | string | No | Article card description |
articleThumbnail | file | No | Optional JPG, PNG, or GIF thumbnail for the article card |
images | file[] | No | JPG, PNG, or GIF images (1 for a single-image post, 2–20 for a multi-image post). Cannot be combined with an article link |
imageAltText | string | No | Alt text applied to the attached images |
| Parameter | Type | Description |
|---|
postId | string | URN of the created post (urn:li:share:… or urn:li:ugcPost:…) |
postUrl | string | Feed URL of the created post |
author | string | Organization URN the post was published as |
contentType | string | text, article, image, or multiImage |
imageUrns | array | Image URNs uploaded for the post |
List posts authored by a LinkedIn Company Page, newest first (organic and sponsored)
| Parameter | Type | Required | Description |
|---|
organization | string | Yes | Organization ID or URN (urn:li:organization:{id}) |
count | number | No | Posts per page (default 10, max 100) |
start | number | No | Index of the first post (default 0); use paging.nextStart for the next page |
sortBy | string | No | LAST_MODIFIED (default) or CREATED, both descending |
viewContext | string | No | READER (default) or AUTHOR to include unpublished versions |
| Parameter | Type | Description |
|---|
posts | array | Posts authored by the Page |
Retrieve a LinkedIn post by its share or ugcPost URN
| Parameter | Type | Required | Description |
|---|
postUrn | string | Yes | Post URN, e.g. urn:li:share:6844785523593134080 or urn:li:ugcPost:… |
viewContext | string | No | READER (default) returns the published version; AUTHOR returns the latest version, including drafts and posts still processing |
| Parameter | Type | Description |
|---|
post | object | The post |
Delete a LinkedIn post by URN. Deletion is idempotent: deleting an already deleted post also succeeds
| Parameter | Type | Required | Description |
|---|
postUrn | string | Yes | URN of the post to delete (urn:li:share:… or urn:li:ugcPost:…) |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether LinkedIn confirmed the deletion |
postUrn | string | URN of the deleted post |
List comments on a LinkedIn post, or replies to a comment when given a comment URN
| Parameter | Type | Required | Description |
|---|
postUrn | string | Yes | Post URN (urn:li:share:… or urn:li:ugcPost:…), or a comment URN to list its replies |
count | number | No | Comments per page (default 10, max 100) |
start | number | No | Index of the first comment (default 0) |
| Parameter | Type | Description |
|---|
comments | array | Comments on the post or replies to the comment |
Comment on a LinkedIn post, or reply to a comment, as a Company Page you administer
| Parameter | Type | Required | Description |
|---|
organization | string | Yes | Organization ID or URN the comment is published as |
postUrn | string | Yes | URN of the post that holds the conversation (urn:li:share:… or urn:li:ugcPost:…) |
text | string | Yes | Comment text |
parentCommentUrn | string | No | Comment URN to reply to (urn:li:comment:(…)); omit to comment on the post itself |
| Parameter | Type | Description |
|---|
comment | object | The created comment |
Get organic impressions, clicks, likes, comments, shares, and engagement for a Company Page: lifetime totals, daily or monthly buckets over a date range, or lifetime totals for specific posts (rolling 12-month window)
| Parameter | Type | Required | Description |
|---|
organization | string | Yes | Organization ID or URN (the member must be a Page ADMINISTRATOR) |
postUrns | string | No | Comma-separated share or ugcPost URNs for per-post lifetime statistics (max 20). Cannot be combined with a time range |
timeGranularity | string | No | DAY or MONTH buckets for time-bound statistics (default DAY when a range is set) |
startTime | string | No | Inclusive range start as epoch milliseconds or an ISO-8601 date |
endTime | string | No | Exclusive range end as epoch milliseconds or an ISO-8601 date |
| Parameter | Type | Description |
|---|
statistics | array | One element for lifetime totals, one per time bucket, or one per requested post. Posts with no activity are omitted and can be read as all zeros |
List the LinkedIn Company Pages the connected member holds an approved role on (ADMINISTRATOR by default)
| Parameter | Type | Required | Description |
|---|
role | string | No | Page role to filter by: ADMINISTRATOR (default), CONTENT_ADMINISTRATOR, DIRECT_SPONSORED_CONTENT_POSTER, ANALYST, CURATOR, RECRUITING_POSTER, LEAD_CAPTURE_ADMINISTRATOR, or LEAD_GEN_FORMS_MANAGER |
start | number | No | Index of the first result (default 0) |
count | number | No | Results per page (default 10, max 100) |
| Parameter | Type | Description |
|---|
organizations | array | Pages the member holds the requested role on |
↳ organizationUrn | string | Organization URN (urn:li:organization:{id}) |
↳ organizationId | string | Numeric organization ID |
↳ role | string | Page role |
↳ state | string | Role state (APPROVED) |
↳ roleAssignee | string | Member person URN |