v2

latestOpenAPI 3.0.3AGPL-3.0 license2026-07-2613501.9 MB

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
datePosted	"past-24h" \| "past-week" \| "past-month"	Filter posts by recency window — works; pair with sortBy:"date" for newest-first
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)

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' (counts shrink cleanly). Natural forms ('last week','this month','24 hours') are normalized server-side. Pair with sortBy:'date' for newest-first.

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.

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, or duplicates).

retryAfterinteger required

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