OpenAPI 3.0.3AGPL-3.0 license2026-08-2011401.7 MB

9217eedacbb8

Search LinkedIn Posts

Search LinkedIn's content index for posts matching your keywords and filters. Returns structured post data including full text, engagement metrics, author info, and URLs.

Required parameters

keywords (string, required): The search terms to match against post content. Examples: "AI automation", "remote work trends", "SaaS growth strategies".

Keyword syntax (Boolean operators)

Keywords support LinkedIn Boolean search syntax:

Exact phrase: "outreach automation" — matches only that exact phrase
AND: AI AND marketing — both terms required (spaces default to AND)
OR: "growth hacking" OR "growth marketing" — either term
NOT: outreach NOT webinar — exclude unwanted terms
Parentheses: (AI OR ML) AND "case study" — group logic

Operators must be UPPERCASE. Precedence: Quotes > Parentheses > NOT > AND > OR.

Available filters

Filter	Type	Description
sortBy	"relevance" \| "date"	Sort by relevance (default) or most recent first
authorJobTitle	string[]	The author's job title, free text. The strongest filter here: two different titles return sets of authors that do not overlap, so asking twice reaches twice as many people
postedBy	string[]	Restrict to your own network: first or following. Far fewer results by nature
contentType	"images" \| "videos" \| "documents"	Filter by media type
authorIndustry	string[]	Author's industry IDs (resolve via /search/linkedin/parameters with type=INDUSTRY)
authorCompany	string[]	Author's company IDs (resolve via /search/linkedin/parameters with type=COMPANY)
datePosted	"past-24h" \| "past-week" \| "past-month"	Filter by recency window. On a high-volume query the newest posts are shared across windows, so the first page can look unchanged while the narrower window holds fewer results

Response fields (per item)

Field	Type	Description
postUrl	string	Direct URL to the LinkedIn post
text	string	Full post text content
date	number	Publication timestamp (ms since epoch)
likesCount	number	Total reactions
commentsCount	number	Total comments
sharesCount	number	Total shares/reposts
author.name	string	Author's display name
author.profileUrl	string	Author's LinkedIn profile URL
author.headline	string	Author's headline
author.isCompany	boolean	Whether the author is a company page
isRepost	boolean	Whether this is a repost of another post

Pagination

Default page size: 10, max: 50
Use start + count to paginate: start=0, count=10 → page 1, start=10, count=10 → page 2
Check hasMore in the response to know if more pages exist
paging.total gives the estimated total number of results

Example workflows

Content research: Search for trending topics → analyze top posts → extract engagement patterns
Lead generation: Search for posts about problems your product solves → extract author profiles
Competitive intelligence: Search for competitor mentions → track sentiment and engagement

Credits

post/search/linkedin/posts

Request body

keywordsstring required

Search keywords (required). Searches across post text content. Supports LinkedIn Boolean syntax: use double quotes for exact phrases (e.g. "AI automation"), AND to require both terms, OR for alternatives (e.g. "growth hacking" OR "growth marketing"), NOT to exclude (e.g. outreach NOT webinar), and parentheses to group (e.g. (AI OR ML) AND "case study"). Operators must be UPPERCASE. Without quotes, multi-word queries are treated as AND by default which may return broad results.

urlstring

Optional LinkedIn search URL. If provided, keywords and filters are extracted from the URL. Explicit params override URL-derived values.

sortBystring

Sort order. 'relevance' (default) or 'date' (most recent first). Natural forms ('newest','recent') are normalized server-side.

datePostedstring

Filter posts by recency window: 'past-24h' < 'past-week' < 'past-month'. Natural forms ('last week','this month','24 hours') are normalized server-side. On a high-volume query the newest posts are shared across windows, so the first page of results can look identical while the narrower window genuinely holds fewer; judge it by how deep the results go rather than by the top of the list.

contentTypestring

Filter by media type: 'images' (photos), 'videos', 'documents' (carousel/PDF). Natural forms ('video','photo','pdf') are normalized server-side.

authorIndustrystring[]

Filter by the post author's industry. Pass human labels (e.g. ['Software Development']) — server resolves to LinkedIn industry IDs via typeahead. Numeric IDs pass through if you already have them.

authorCompanystring[]

Filter by the post author's company. Pass company names (e.g. ['Google','Stripe']) — server resolves to LinkedIn company IDs via typeahead. Numeric IDs pass through if you already have them.

authorJobTitlestring[]

Filter by the post author's job title, as free text. The strongest filter on post search by a wide margin: two different titles return sets of authors that do not overlap at all, so it is also the best way to reach more people by asking twice. Needs no id, unlike the industry and company filters.

postedBystring[]

Restrict to posts from your own network: 'first' for first-degree connections, 'following' for people you follow. Returns far fewer results than an open search by nature, since it is bounded by who you know rather than by everything LinkedIn has indexed.

startinteger

Pagination offset (default 0). Use multiples of count to page through results. Example: start=0 for page 1, start=10 for page 2 (with count=10).

countinteger

Results per page (default 10, max 50). Controls how many posts are returned per request.

Response

List of LinkedIn posts matching the search criteria

successtrue required

category'posts' required

hasMoreboolean required

creditsUsedinteger required

Credits consumed by this call. 0 for free endpoints, cached results, duplicates, and for every query that does not touch LinkedIn.

retryAfterinteger required

Seconds to wait before another call of the same type. 0 means no wait is needed.