Api

Search LinkedIn posts

Search public LinkedIn posts site-wide by keyword (not scoped to one profile or company — use linkedin.profiles.posts.list or linkedin.company.posts.list for…

GET/v1/linkedin/posts/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

Keyword or phrase to search for in public LinkedIn posts.

min 1 chars · max 512 chars

datePostedstringoptionalquery

Optional filter for how recently matching posts were published.

one of: last-hour, last-day, last-week, last-month, last-year

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
33

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Matching LinkedIn posts for the current page.

dataposts[]id
stringnullable

LinkedIn activity id for the post (the number in urn:li:activity:<id>) when available. Matches the id returned by the company and profile post lists.

min 1 chars

dataposts[]url
string

Canonical public URL for this LinkedIn post.

min 1 chars

dataposts[]title
stringnullable

Page title for the post when available, usually a short headline followed by the author name. Article and video posts often carry their own title here.

dataposts[]text
stringnullable

Full text body of the post when available.

dataposts[]publishedAt
stringnullable

ISO-8601 timestamp for when the post was published, when available.

dataposts[]mediaUrl
stringnullable

Primary media URL for the post when available.

dataposts[]imageUrl
stringnullable

Primary image URL for the post when available.

Image URLs associated with the post when available.

dataposts[]imageUrls[]
stringoptional

min 1 chars

dataposts[]thumbnailUrl
stringnullable

Source-platform CDN URL for a video cover or thumbnail when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset.

Author of the post when available.

dataposts[]authorname
string

Display name of the author.

min 1 chars

dataposts[]authorprofileUrl
stringnullable

Public profile URL for the author when available.

dataposts[]authoravatarUrl
stringnullable

Avatar image URL when available.

dataposts[]authorfollowers
integernullable

Follower count when available.

≥ 0

Engagement metrics for the post.

dataposts[]metricsreactions
integernullable

Total reactions when available.

≥ 0

dataposts[]metricscomments
integernullable

Comment count when available.

≥ 0

Top-level comments shown with the post, in the same shape as linkedin.post.get. Usually a few top comments, not the full thread. Empty when none are available.

dataposts[]comments[]authorName
stringnullable

Display name of the commenter.

dataposts[]comments[]text
stringnullable

Comment body text.

dataposts[]comments[]profileUrl
stringnullable

Public profile URL for the commenter when available.

Pagination state for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more posts are available.

datapagehasMore
boolean

Whether another page of posts is available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/linkedin/posts/search?query=ai%20agents" \
  -H "x-api-key: YOUR_API_KEY"

Responses

LinkedIn post search results.