Read-only

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.

list_postsGET/api/v1/content/posts

Get started View docs

crispy — bash

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
  }
]

Permission scope

core

Access

Read-only

What you can build

Review a prospect's recent posts to find relevant conversation starters

Surface your top-performing posts by impressions or engagement rate

Audit a company page's recent content cadence and themes

Identify which past posts to repurpose based on engagement

Parameters

Inputs accepted by list_posts.

Name	Type	Required	Description
identifier	`string`	optional	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"`	optional	Sort order: 'recent' (default, chronological by identifier) or 'top' (your top posts by engagement score).
limit	`number`	optional	Max number of posts to return (1-100 for recent, 1-25 for top; default 20/10)
metric	`"impressions" \| "reactions" \| "comments" \| "reposts" \| "engagement_rate"`	optional	Rank by this metric when sort='top' (default: impressions)
days	`number`	optional	Look back this many days when sort='top' (default 30)
is_company	`boolean`	optional	Set to true if the identifier is a company (sort='recent' only)
cursor	`string`	optional	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.

Explore all Content tools

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.

Connect your first profile

Read the docs