LinkedIn Post Search API
Find the public LinkedIn posts that mention a keyword, a name, a phrase or a #hashtag, and get each one back as clean JSON with the full text, the author and their headline, the date, reactions, comments, images and links. No LinkedIn account, no login and no session cookie.
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| keywords | string[] | yes | — | Names, phrases, companies or #hashtags to find, as plain words. Each is searched as an exact phrase. Up to 20 per run; search operators and quote marks are refused. |
| postedWithin | string | no | any | Only posts from the past day, week, month or year. Ignored when a start or end date is set. |
| startDate | string | no | — | Only posts published on or after this day (YYYY-MM-DD, UTC). |
| endDate | string | no | — | Only posts published on or before this day (YYYY-MM-DD, UTC). |
| maxPostsPerKeyword | integer | no | 50 | Stop after delivering this many posts for one keyword, 1 to 1,000. — drives your bill |
| includeArticles | boolean | no | false | Also search long-form LinkedIn articles. Each keyword then runs two searches. |
Output schema
| FIELD | TYPE | DESCRIPTION | NULLABLE |
|---|---|---|---|
| postUrl | string | The public post link | no |
| postId | string | LinkedIn's post id | no |
| datePosted | string | When the post was published (UTC) | yes |
| text | string | The full post text | yes |
| authorName | string | Who posted it | yes |
| authorUrl | string | The author's profile or company URL | yes |
| authorType | string | Person or organization | yes |
| authorHeadline | string | The author's headline, when shown | yes |
| authorFollowers | integer | The author's follower count, when shown | yes |
| numLikes | integer | Reactions | yes |
| numComments | integer | Comment count | yes |
| topComments | array | Up to 10 comments a signed-out visitor can see | yes |
| hashtags | array | Hashtags used in the post | yes |
| taggedPeople | array | People mentioned with an @ tag | yes |
| taggedCompanies | array | Companies mentioned with an @ tag | yes |
| matchedKeyword | string | Which of your keywords found the post | no |
| fromCache | boolean | Whether the post came from the shared cache | no |
Worked examples
{
"keywords": ["Your Company Name", "Your CEO's Name"],
"postedWithin": "day",
"maxPostsPerKeyword": 100
}
{
"keywords": ["Jackson Hole Symposium"],
"startDate": "2026-08-18",
"endDate": "2026-08-25"
}
{
"keywords": ["#semiconductors"],
"postedWithin": "week"
}
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~linkedin-post-search-api/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"keywords": ["Jackson Hole Symposium"], "postedWithin": "week", "maxPostsPerKeyword": 20}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/linkedin-post-search-api").call(
run_input={"keywords": ["#semiconductors"], "postedWithin": "day"}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
Claude Code (MCP)
claude mcp add --transport http linkedin-post-search \ "https://mcp.apify.com/?tools=actors,docs,johnvc/linkedin-post-search-api"
MCP
Apify's hosted MCP server loads this source from the URL below as the tool johnvc--linkedin-post-search-api. Sign in to Apify when your client asks (OAuth), or send an Apify token as an Authorization: Bearer header.
https://mcp.apify.com/?tools=johnvc/linkedin-post-search-api
Alternatives
Questions people ask
How do I search LinkedIn posts by keyword?
Put the keyword, name, phrase or #hashtag in keywords as plain words and run it. Each keyword is matched as an exact phrase across public LinkedIn posts, and every matching post comes back as a row with its text, author, date and engagement.
Can I search LinkedIn posts without a LinkedIn account?
Yes, for public posts. The LinkedIn Post Search API reads only what a signed-out visitor can see. It has no input for an account, a password or an li_at session cookie, so nothing it does is tied to your LinkedIn account.
How much does the LinkedIn Post Search API cost?
A run is billed per post delivered and per page of search results fetched fresh. There is no start fee. Search pages already in the shared cache are free, and error rows and posts outside your date window are never charged.
Can I limit LinkedIn post search to a date range?
Yes. Set postedWithin to the past day, week, month or year, or set startDate and endDate for any range. Each post's own timestamp is checked against the window before it is delivered.
How quickly do new LinkedIn posts show up?
Within hours, not seconds. In the Actor's own testing, posts appeared in a past-day search three to four hours after they were published, so a daily monitor is usually complete by the next morning.
Does it return comments and reactions?
It returns the reaction and comment counts for every post, and up to 10 comments per post, which is what LinkedIn shows a signed-out visitor. It does not list who reacted.
Can an AI agent use the LinkedIn Post Search API over MCP?
Yes. It is a tool on Apify's hosted MCP server for Claude, Cursor and other agents, so an agent can run a search and rank the posts by reactions itself. It is also available over REST.