LinkedIn
GET /v1/linkedin/search-posts

LinkedIn Search Posts API

Run a LinkedIn search posts and get structured, ranked results as clean JSON.

~16 credits (0.8/result) per request
TL;DR
Run a LinkedIn search posts and get structured, ranked results as clean JSON. The LinkedIn Search Posts API (LinkedIn) is a single authenticated GET request to /v1/linkedin/search-posts that responds with clean JSON and costs ~16 credits (0.8/result). Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.

What is the LinkedIn Search Posts API?

The LinkedIn Search Posts API lets you search and return matching results for LinkedIn search posts with a single REST call. No OAuth, no infrastructure to maintain, and no platform SDKs — send the request, get clean structured JSON back. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d.

What you get

  • Ranked, structured result list
  • Title, URL, author, and thumbnail per result when available
  • Engagement metrics where the platform exposes them
  • Configurable result limit

Try it

Open in Playground

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

Parameters

Sign in to run live
curl "https://api.captapi.com/v1/linkedin/search-posts?q=artificial%20intelligence" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "data": {
    "query": "artificial intelligence",
    "sort": "relevance",
    "totalReturned": 5,
    "posts": [
      {
        "platform": "linkedin",
        "type": "post",
        "url": "https://www.linkedin.com/posts/edward-hallett-9aa4406b_ai-is-a-tool-we-need-to-remember-that-activity-7460399963181617152-BX0D",
        "text": "AI is a tool. \n\nWe need to remember that because it presents as intelligence. But intelligence is sentient.\n\nThat’s why we call it *artificial* intelligence \n\nIt’s artificial because ai only appears to create meaning. \n\nIn fact, there can be no meaning created by ai. \n\nMeaning only ever persists in the humans who engage with ai. (Meaning is the unique condition of being human).  \n\nThink of ai as a ‘magic mirror’ or an ‘echo chamber’. It returns our words and images to us with heightened grandeur and clarity.\n\nI’m grateful for AI. \n\nAi can help with the task of route optimization or translation.\n\nBut it cannot establish whether the destination is worth getting to, or whether the translated text is moving (for that someone needs to be moved). \n\nSo what? \n\nRemembering that this intelligence is artificial helps us delineate what within the province of human productivity cannot for structural reasons be substituted for by ai.\n\nThis is because human beings value intelligence (sentience) in the realm of productivity.\n\nI return to my chosen advisor (broker, therapist, architect) not just bec …",
        "publishedAt": "2026-05-13T18:45:58.726Z",
        "author": {
          "name": "Edward Hallett",
          "url": "https://www.linkedin.com/in/edward-hallett-9aa4406b"
        },
        "engagement": {
          "likes": 57,
          "comments": 3
        },
        "id": "7460399963181617152"
      },
      {
        "platform": "linkedin",
        "type": "post",
        "url": "https://www.linkedin.com/posts/ebender_when-people-ask-me-what-the-phrase-artificial-activity-7480663649716494336-Wnbx",
        "text": "When people ask me what the phrase \"artificial intelligence\" means, my short answer is, it means \"venture capitalists, give me some money\".\n\nBut OUP asked me for a longer answer, given here and summarized in the section headings:\n\nhttps://lnkd.in/gb28PW5k\n\nPreprint available from my publications page:\nhttps://lnkd.in/gW-KW9DY",
        "publishedAt": "2026-07-08T16:46:38.081Z",
        "author": {
          "name": "Emily M. Bender",
          "url": "https://www.linkedin.com/in/ebender"
        },
        "engagement": {
          "likes": 524,
          "comments": 18
        },
        "id": "7480663649716494336"
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Top-level fields

  • queryThe search query you sent.
  • sortSort. Example: "relevance".
  • totalReturnedNumber of items returned in this response.

Posts

Each item in posts contains:

  • platformPlatform identifier for this response (matches the endpoint's platform).
  • typeContent type of the item.
  • urlCanonical URL of the item.
  • textText content.
  • publishedAtPublish date (ISO 8601) when the platform exposes an absolute timestamp.
  • authorAuthor name or handle.
  • engagementEngagement metrics for the item.
  • idStable platform ID for the item.

Parameters

NameTypeRequiredDescription
qstringYesSearch query or keywords (min 2 characters).
sortstringNorelevance or date. Default relevance.
limitintegerNoMax items to return (default 20, max 50). Billed per result.
cachebooleanNoSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs ~16 credits (0.8/result) — billed per result, so the exact amount scales with how many items you request. Pass cache=true for a free 24h cache hit; default is always fresh (metrics refresh within ~1 hour).

Using an AI agent? This endpoint is the MCP tool linkedin_search_posts via @captapi/mcp. Set it up →

How it works

  1. 1. Sign up — get 100 free credits, no card required.
  2. 2. Create a key from your dashboard.
  3. 3. Send one request to /v1/linkedin/search-posts and parse the JSON response.

Use cases

Trend Discovery

Find trending content by keyword or hashtag.

Content Sourcing

Build feeds and playlists programmatically.

Monitoring

Track topics, brands, and competitors.

Research

Sample large sets of content for analysis.

Frequently asked questions

What does the LinkedIn Search Posts API do?+

The LinkedIn Search Posts API lets you search and return matching results from a public LinkedIn query using one GET request to /v1/linkedin/search-posts. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the LinkedIn Search Posts API cost?+

At the default limit this endpoint costs 16 credits (0.8 per result). Billing scales with how many results you request. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a LinkedIn API key or OAuth?+

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the LinkedIn Search Posts API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

More LinkedIn APIs

Ready to use the LinkedIn Search Posts API?

Sign up, grab your key, and make your first call in 60 seconds.