Social Fetch
LinkedIn

Get LinkedIn post or article

Returns public metadata for a single LinkedIn feed post or article. Availability is indicated in `data.lookupStatus` as `found` or `not_found`.

Operation

GET/v1/linkedin/posts
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Public permalink to the post or article.

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the URL could be resolved to public content.

one of: found, not_found

datapost
objectrequirednullable

Primary item when found.

datapostcontentType
stringrequired

Whether this URL resolved to a feed-style post or an article.

one of: post, article

dataposturl
stringrequired

Canonical or resolved public URL for this item.

min 1 chars

dataposttitle
stringrequirednullable

Title for long-form articles when available.

datapostheadline
stringrequirednullable

Subtitle or lead line when available.

datapostdescription
stringrequirednullable

Full body text when available.

datapostpublishedAt
stringrequirednullable

Publication timestamp or date string when available.

dataauthor
objectrequirednullable

Author when found.

dataauthorname
stringrequired

Display name of the author.

min 1 chars

dataauthorprofileUrl
stringrequirednullable

Public profile URL for the author when available.

dataauthoravatarUrl
stringrequirednullable

Avatar image URL when available.

dataauthorfollowers
integerrequirednullable

Follower count when available.

≥ 0

datametrics
objectrequirednullable

Engagement metrics for the post or article.

datametricsreactions
integerrequirednullable

Total reactions when available.

≥ 0

datametricscomments
integerrequirednullable

Comment count when available.

≥ 0

datacomments
arrayrequired

Top-level comments when available.

datacomments[]authorName
stringrequirednullable

Display name of the commenter.

datacomments[]text
stringrequirednullable

Comment body text.

datacomments[]profileUrl
stringrequirednullable

Public profile URL for the commenter when available.

datarelatedArticles
arrayrequired

Related items from the same author when available.

datarelatedArticles[]url
stringrequired

Permalink to the related item.

datarelatedArticles[]title
stringrequirednullable

Title when available.

datarelatedArticles[]publishedAtLabel
stringrequirednullable

Human-readable publication label when only a label is available.

datarelatedArticles[]description
stringrequirednullable

Short summary text when available.

datarelatedArticles[]reactions
integerrequirednullable

Reaction count when available.

≥ 0

datarelatedArticles[]comments
integerrequirednullable

Comment count when available.

≥ 0

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Post or article metadata (found or not found in body).

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page