API Reference/Endpoints
Retrieve a post
GET/api/linkedin/gateway/posts/{post_id}
Looks up a single post — engagement counters, the author, any attached poll, article or job posting, and (where the connected account has access) reach analytics.
Authentication
Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.
Path parameters
FieldTypeDescription
post_id *stringWhich id to use depends on where the URL came from. A profile-feed URL containing activity gives you a plain numeric id — use that directly. A URL containing ugcPost or share instead needs the full urn:li:ugcPost:ID / urn:li:share:ID form.
Query parameters
FieldTypeDescription
account_id *stringA connected account's id.
Response fields
FieldTypeDescription
object"Post"Always this value.
id / social_idstringThe post's own id and its stable social urn.
textstringThe post body.
reaction_counter / comment_counter / repost_counter / impressions_counternumberEngagement counters as of the time of the call.
authorobjectWho published it — id, name, headline, whether it's a company page.
permissionsobjectWhat the connected account can do with it: can_react, can_share, can_post_comments.
poll / article / job_posting / groupobjectPresent only when the post carries that kind of attachment.
analyticsobjectImpressions, engagement rate and clickthrough data, when the account has access to it.
The engine also fronts Instagram accounts, so a post fetched from one of those returns a differently shaped body — like/comment counts, caption, video and owner fields — under the same object: "Post" envelope.
Errors
·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key, or this feature isn't on the connected account's plan.·404 Not Found. No post exists for that id, or the account can no longer see it.
