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

# search_linkedin_jobs

> LinkedIn's public job search by keyword and location: title, company, location, posted date, link and salary where shown. ₹0.15 per call; no job cards is ₹0.

## What it does

Send a `query` (a title or keywords) and a `location` and get `data[]`, one row per job card: `title`, `company`, `location`, `posted` (LinkedIn's relative text) and `posted_on` (the date), `salary` when LinkedIn shows one, `job_id` and `url`, up to `limit` per call (default 25) with `start` for the next page. `posted` keeps to the last `day`, `week` or `month`.

Use it to see who is hiring for a role in a city, or how many openings a competitor has. For one posting in full use [`get_linkedin_job`](https://parel.si/docs/tools/get_linkedin_job.md), for postings by company and funding [`search_jobs`](https://parel.si/docs/tools/search_jobs.md), for the company [`get_linkedin_company`](https://parel.si/docs/tools/get_linkedin_company.md). A search almost always returns cards, even for nonsense (it did in the live check), so judge the titles against the query.

This source sits below the batch rule's 95% success (93% on the upstream's numbers) and was switched on by the founder's decision; a failed run is ₹0 and can be retried.

India: `location: "Mumbai"` or `"India"` works; the cards are what LinkedIn shows a logged-out visitor in that market.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | How many job cards, up to 50. Default 25.; max 50 |
| `query` | string | yes | The job title or keywords ("marketing manager"). |
| `start` | integer | no | Offset into the results, for the next page. Default 0. |
| `posted` | string | no | How recent: day, week or month. Leave empty for all. |
| `location` | string | no | A city, country or "Remote". |

## What drives the cost

Nothing you can turn: flat per call whatever `limit` says; each page (`start`) is a call. No job cards is `class: "ok_free"`, ₹0. Slow: five to fifty seconds, so the timeout is two minutes.

## Price today

| | |
|---|---|
| Price today | **₹0.15** per call (`cost_paise: 15`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); 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 | 159 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_linkedin_jobs"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_linkedin_jobs"` |
| 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_jobs","input":{"limit":10,"query":"marketing manager","posted":"week","location":"Mumbai"}}'
```

## What comes back

`data[]`. A real answer recorded during the live check of 2026-11-05 (marketing manager jobs in Mumbai this week, five cards in 8 s), trimmed to three:

```json
[
  {
    "company": "Axis My India",
    "job_id": "4484328428",
    "location": "Mumbai Metropolitan Region",
    "posted": "5 days ago",
    "posted_on": "2026-10-30",
    "salary": null,
    "title": "Marketing Manager (ATL & BTL)",
    "url": "https://in.linkedin.com/jobs/view/marketing-manager-atl-btl-at-axis-my-india-4484328428"
  },
  {
    "company": "Axis My India",
    "job_id": "4485694183",
    "location": "Mumbai Metropolitan Region",
    "posted": "4 days ago",
    "posted_on": "2026-10-31",
    "salary": null,
    "title": "Marketing Manager",
    "url": "https://in.linkedin.com/jobs/view/marketing-manager-at-axis-my-india-4485694183"
  },
  {
    "company": "Emkay Global Financial Services Ltd",
    "job_id": "4478265642",
    "location": "Mumbai Metropolitan Region",
    "posted": "6 days ago",
    "posted_on": "2026-10-30",
    "salary": null,
    "title": "Manager - Marketing (Wealth Management)",
    "url": "https://in.linkedin.com/jobs/view/manager-marketing-wealth-management-at-emkay-global-financial-services-ltd-4478265642"
  }
]
```

## Notes

- Flat per call; no job cards is free. Each page (start) is a call.
- Slow: five to fifty seconds; the timeout is two minutes.
- The source's success rate is 93% on the upstream's numbers; a failed run is free and can be retried.

## Siblings

- [`get_linkedin_job`](https://parel.si/docs/tools/get_linkedin_job.md) for one posting in full.
- [`search_jobs`](https://parel.si/docs/tools/search_jobs.md) for postings by company and funding.
