> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn Posts API

> LinkedIn posts from any profile, company, post or feed URL, or by search with author, mention and content-type filters. Same clean record either way.

`POST /v1/data/linkedin/posts/run`

**Pricing:** $0.002 per post ($2.00 per 1,000).

## Ways to call it

* **URL**: set `urls` (optional: `includeQuotePosts`, `includeReposts`)
* **Search**: set `queries` (optional: `sortBy`, `authors`, `mentioning`, `contentType`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**urls** `string`

LinkedIn URL to scrape posts from: profile, company, post, or feed links.

Format e.g. `https://www.linkedin.com/in/satyanadella`.

**queries** `string`

Keyword to search LinkedIn posts for.

**maxResults** `integer`

Posts to return. Use 0 for all.

**postedLimit** `string` (default: any)

Only posts within this time window.

Allowed values: `any` (Any time), `1h` (Past hour), `24h` (Past 24 hours), `week` (Past week), `month` (Past month), `3months` (Past 3 months), `6months` (Past 6 months), `year` (Past year).

**includeQuotePosts** `boolean`

Quote posts (shared with commentary).

**includeReposts** `boolean` (default: true)

Reposts (shared without commentary).

**sortBy** `string`

Sort order for results.

Allowed values: `relevance` (Relevance), `date` (Most recent).

**authors** `string[]`

Filter posts to specific authors. Accepts profile URLs or company names ('Google').

**mentioning** `string[]`

Filter posts that mention specific people or companies. Accepts profile URLs or names.

**contentType** `string`

Filter to a specific media type.

Allowed values: `all`, `videos`, `images`, `jobs`, `live_videos`, `documents`, `collaborative_articles`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/linkedin/posts/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": "https://www.linkedin.com/in/satyanadella/",
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/linkedin/posts/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "urls": "https://www.linkedin.com/in/satyanadella/",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/linkedin/posts/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "urls": "https://www.linkedin.com/in/satyanadella/",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one post, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `postUrl` | Post URL | url |
| `postId` | Post ID | text |
| `postText` | Post Text | text |
| `authorName` | Author Name | text |
| `authorUrl` | Author URL | url |
| `authorProfileId` | Author Profile ID | text |
| `authorHandle` | Author Handle | text |
| `authorAvatar` | Author Avatar | image |
| `authorType` | Author Type | text |
| `authorHeadline` | Author Headline | text |
| `authorFollowers` | Author Followers | number |
| `reactions` | Reactions | number |
| `comments` | Comments | number |
| `shares` | Shares | number |
| `postedDate` | Posted Date | text |
| `repostNote` | Repost Note | text |
| `articleUrl` | Article URL | url |
| `postMediaUrl` | Post Media URL | url |
| `postMediaType` | Post Media Type | text |
| `mentions` | Mentions | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "linkedin/posts",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "authorHeadline": "CEO, Microsoft AI",
      "authorAvatar": "https://media.licdn.com/dms/image/v2/D4E03AQH__Hh7CEcg-A/profile-displayphoto-shrink_800_800/B4EZcSqB4VHsAc-/0/1748364697584?e=1788393600&v=beta&t=jjvXkJEJCB...",
      "authorType": "profile",
      "articleUrl": null,
      "postText": "Our first reasoning model, MAI-Thinking-1, is built from scratch. Now available in Microsoft Foundry. Kudos to the team! More details in the blog: https://ln...",
      "authorHandle": "mustafa-suleyman",
      "postedDate": "2026-08-12T17:11:08.073Z",
      "authorName": "Mustafa Suleyman",
      "repostNote": "Satya Nadella reposted this",
      "shares": 271,
      "postUrl": "https://www.linkedin.com/posts/ugcPost-7493339243377807361-A7zq",
      "authorFollowers": null,
      "postMediaUrl": "https://dms.licdn.com/playlist/vid/v2/D5605AQGYDtQW0JnTUw/mp4-720p-30fp-crf28/B56Z_2wVumGcCA-/0/1786551296160?e=1787547600&v=beta&t=fhkQ5jV4BzRLkWIPMHZN0lKiV...",
      "postMediaType": "VIDEO",
      "comments": 118,
      "authorUrl": "https://www.linkedin.com/in/mustafa-suleyman",
      "reactions": 2325,
      "mentions": [
        {
          "name": null,
          "handle": null,
          "url": "https://lnkd.in/gCM9QxVV",
          "type": "TEXT_LINK",
          "id": null
        }
      ],
      "authorProfileId": "ACoAAA9eyYUBh9JQIB19tmDanxKjRK9p8Nw4FrY",
      "postId": "7493353390517768193"
    }
  ]
}
```

## Related APIs

For the comments or reactions on a post use [`linkedin/post-comments`](https://docs.mindcase.co/apis/linkedin/post-comments) or [`linkedin/post-reactions`](https://docs.mindcase.co/apis/linkedin/post-reactions); for what a member commented or reacted to elsewhere use [`linkedin/profile-comments`](https://docs.mindcase.co/apis/linkedin/profile-comments) or [`linkedin/profile-reactions`](https://docs.mindcase.co/apis/linkedin/profile-reactions).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.