---
title: "Search LinkedIn Posts"
method: GET
path: "/v1/linkedin/posts"
tags: ["LinkedIn"]
---

# Search LinkedIn Posts

`GET /v1/linkedin/posts`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/linkedin/posts`
- Auth: API key in header `X-API-Key`

Search for LinkedIn posts by keyword. Returns post content, author information, engagement metrics (likes, comments, shares, reactions), and attached content entities (images, articles, videos, job listings). Includes a has_content_entities flag, true when the post has an attached image, article, video, or job. Results can be sorted by most recent or relevance, and limited to posts from the past 24 hours, week, or month.

**Price:** $0.006 per request. **Free tier:** 50 requests/month.

## Query parameters

- `query` string
- `page` integer
- `sort_by` 'most_recent' | 'relevance'
- `posted_ago` '24h' | '7d' | '30d'
- `author` string
- `mentions_member` string
- `from_company` string
- `author_company` string
- `mentions_company` string
- `author_title` string
- `author_industry` string
- `get_sentiment` boolean

## Response `200`

Successful response

- SearchLinkedinResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `count` number, nullable
  - `page` number, nullable
  - `posts` object[], nullable
    - `article` object, nullable
      - `description` string, nullable
      - `subtitle` string, nullable
      - `title` string, nullable
      - `url` string, nullable
    - `author` string, nullable
    - `comments` number, nullable
    - `date` string, nullable
    - `domain` string, nullable
    - `has_content_entities` boolean, nullable
    - `images` string[], nullable
    - `job` unknown
    - `likes` number, nullable
    - `reactions` object, nullable
      - `interest` number, nullable
      - `like` number, nullable
      - `appreciation` number, nullable
      - `entertainment` number, nullable
      - `praise` number, nullable
    - `shares` number, nullable
    - `snippet` string, nullable
    - `source` string, nullable
    - `title` string, nullable
    - `url` string, nullable
    - `urn` string, nullable
    - `video` object, nullable
      - `duration` number, nullable
      - `thumbnail` string, nullable

## Other responses

- `400`: Bad request: missing or invalid parameters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving LinkedIn data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)
