> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_linkedin_posts

# search_linkedin_posts

> LinkedIn posts by keyword with author, text and engagement. ₹1.62 at most per search of up to 25 posts.

## What it does

LinkedIn posts by keyword: `data.posts[]` with `text`, `url`, `createdUtc`, `engagement` (reactions and comments) and `author`. `datePosted` defaults to the last day, so widen it for a quiet subject. `authorKeywords` and `authorCompanyNames` narrow to who wrote it.

Keyword search is loose: posts that merely use the words come back too, so quote exact phrases and read the results. For one person's posts use [`get_linkedin_posts`](https://parel.si/docs/tools/get_linkedin_posts.md), and for a company's [`get_linkedin_company_posts`](https://parel.si/docs/tools/get_linkedin_company_posts.md).

India: put India or a city in the query; there is no country filter.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `sort` | `relevance` or `date` | no | relevance (the default) or date. |
| `limit` | integer | no | How many posts, 1 to 25. Default 10.; min 1, max 25 |
| `query` | string | yes | The search: words, quoted phrases or Boolean operators, as in LinkedIn's own search. |
| `datePosted` | `last-hour` or `last-day` or `last-week` or `last-month` or `last-three-months` or `last-six-months` or `last-year` | no | How far back to look. Default last-day. |
| `contentType` | `all` or `videos` or `images` or `jobs` or `live-videos` or `documents` or `collaborative-articles` | no | Only posts of this kind. |
| `authorKeywords` | string | no | Only authors with this in their headline or job title. |
| `authorCompanyNames` | array of values | no | Only authors at these companies. |

## What drives the cost

Charged per search, up to 25 posts (`limit`, default 10). The source reports what each call cost and that is what you pay, so the price shown is the most it can be: live calls of 5, 10 and 25 posts all cost the same, well under it. A nonsense query still matches something and is charged.

## Price today

| | |
|---|---|
| Price today | **₹1.62** per search (`cost_paise: 162`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.43 (`hold_paise: 243`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_linkedin_posts"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_linkedin_posts"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_linkedin_posts","input":{"limit":10,"query":"D2C India founder","datePosted":"last-week"}}'
```

## What comes back

`data.posts[]`. A real answer recorded during the live check of 2026-11-05, trimmed to one post, with the author replaced:

```json
{
  "posts": [
    {
      "author": {
        "name": "Asha Example"
      },
      "createdUtc": 1793716414,
      "engagement": {
        "comments": 0,
        "reactions": 10
      },
      "id": "7523391931754799104",
      "text": "Founder Files | Ep. 117: Founder vs Founder\n\n“India mein D2C brand product quality se jeete ya marketing se?”\n\nVineeta Singh: SUGAR Cosmetics. IIT Madras + IIM Ahmedabad. ₹1 crore job offer refuse ki.…",
      "url": "https://www.linkedin.com/feed/update/urn:li:activity:0000000000000000000"
    }
  ]
}
```

## Notes

- Charged per search for up to 25 posts; the price shown is the most it can be.
- Keyword matching is loose, so quote phrases and check the results.
- datePosted defaults to last-day.
- No country filter: name the place in the query.

## Siblings

- [`get_linkedin_posts`](https://parel.si/docs/tools/get_linkedin_posts.md) for one person's posts.
- [`get_linkedin_post_comments`](https://parel.si/docs/tools/get_linkedin_post_comments.md) for what people said on a post.
- [`get_linkedin_post_reactions`](https://parel.si/docs/tools/get_linkedin_post_reactions.md) for who reacted.
