List LinkedIn Posts
List LinkedIn posts in two modes: recent posts in chronological order for a given profile or company, or your own top posts ranked by a chosen engagement metric. Recent mode requires an identifier (provider ID, slug, or URL), while top mode ranks your posts by impressions, reactions, comments, reposts, or engagement rate over a lookback window. Returns an empty array when no posts are found.
Example prompt: Show me my top 5 posts by engagement rate from the last 30 days
[
{
"post_id": "urn:li:activity:7012345678901234567",
"text": "The biggest GTM mistake I see...",
"engagement_rate": 0.072,
"impressions": 14820
}
]What you can build
Parameters
Inputs accepted by list_posts.
| Name | Type | Description |
|---|---|---|
| identifier | string | Whose posts to list. Accepts provider_id (e.g. 'ACoAABGDkeIB...'), slug (e.g. 'john-doe-123'), or full URL. Required for sort='recent'. |
| sort | "recent" | "top" | Sort order: 'recent' (default, chronological by identifier) or 'top' (your top posts by engagement score). |
| limit | number | Max number of posts to return (1-100 for recent, 1-25 for top; default 20/10) |
| metric | "impressions" | "reactions" | "comments" | "reposts" | "engagement_rate" | Rank by this metric when sort='top' (default: impressions) |
| days | number | For recent posts, return only posts published within this many days; for top posts, look back this many days (default 30). Undated posts are excluded from recent results. |
| is_company | boolean | Set to true if the identifier is a company (sort='recent' only) |
| cursor | string | Pagination cursor (sort='recent' only) |
Related tools
Get LinkedIn Post
Retrieve any LinkedIn post by ID to read its content, author, and engagement metrics. Fast lookups for analysis and follow-up via MCP.
Get Post Analytics
Pull impressions, reactions, comments, and reposts for any LinkedIn post by ID so your agent can measure reach and engagement instantly.
List Scheduled LinkedIn Posts
List your scheduled LinkedIn posts with status and scheduled times, filterable by pending, published, failed, or cancelled via MCP.
Get LinkedIn Feed
Pull your LinkedIn feed with engagement counts and sponsored flags, and filter out ads. Find posts worth engaging with via MCP.
Run LinkedIn workflows from the AI client you already use.
Create your account, connect LinkedIn, create an API key, then add Crispy to your client. Review the docs for supported workflows and safety controls.