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

# get_linkedin_job

> One LinkedIn job posting in full: title, company, location, description, employment type, salary where shown, applicants. ₹0.20 per posting.

## What it does

One LinkedIn job from its `jobId` (the number at the end of the job URL) or `url`, in `data.element`: `title`, `company`, `location`, `descriptionText`, `employmentType`, `workplaceType`, `salary` (text, min, max) where LinkedIn shows it, `applicants`, `postedDate`, `jobFunctions` and `industries`. Use it to read a posting in full; for lists of postings [`search_jobs`](https://parel.si/docs/tools/search_jobs.md).

India: any public posting; salary appears only where the poster added it.

## Inputs

Generated from the contract captured from staging on 2026-11-05. This tool declares one-of sets: `jobId` or `url` must be present, or it is `invalid_input` for ₹0.

| Field | Type | Required | Description |
|---|---|---|---|
| `url` | string | one of | URL of the LinkedIn job (optional) |
| `jobId` | string | one of | ID of the LinkedIn job (optional). e.g. "4465308031" |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `jobId`; `url`.

## What drives the cost

Nothing: flat per call. Usually one to three seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.20** per posting (`cost_paise: 20`) 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 | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_linkedin_job"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_linkedin_job"` |
| 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":"get_linkedin_job","input":{"jobId":"4465308031"}}'
```

## What comes back

`data.element`. A real answer recorded during the live check of 2026-10-28, trimmed (long text cut):

```json
{
  "element": {
    "id": "4465308031",
    "title": "Software Engineer - API Development",
    "linkedinUrl": "https://www.linkedin.com/jobs/view/4465308031/",
    "jobState": "CLOSED",
    "postedDate": "2026-09-09T19:44:58.000Z",
    "headerCaptionText": null,
    "descriptionText": "About The Company\n\nUSAA is a leading financial services organization dedicated to serving the military community and their families. Our mission is to empower our members to achieve financial security through highly competitive products, exceptional service, and trusted advice. We pride ourselves on maintaining core values such as honesty, integrity, loyalty…",
    "descriptionHtml": "<b>About The Company<br><br><br><br></b>USAA is a leading financial services organization dedicated to serving the military community and their families. Our mission is to empower our members to achieve financial security through highly competitive products, exceptional service, and trusted advice. We pride ourselves on maintaining core values such as honest…",
    "location": {
      "linkedinText": "United States",
      "postalAddress": null,
      "countryCode": "us",
      "geoId": "103644278",
      "parsed": {
        "text": "United States",
        "countryCode": "US",
        "regionCode": null,
        "country": "United States",
        "countryFull": "United States of America"
      }
    },
    "employmentType": "full_time",
    "workplaceType": "remote",
    "workRemoteAllowed": true,
    "easyApplyUrl": null,
    "applyMethod": {
      "companyApplyUrl": "https://www.fetchjobs.co/job-description-usg/3170428063?src=LinkedIn",
      "applyStartersPreferenceVoid": true,
      "inPageOffsiteApply": false,
      "type": "OffsiteApply"
    },
    "applicants": 0,
    "hiringTeam": [],
    "company": {},
    "salary": {
      "text": null,
      "min": null,
      "max": null
    },
    "jobFunctions": [
      "IT"
    ],
    "industries": [
      "Technology, Information and Media"
    ],
    "experienceLevel": "Associate",
    "benefits": [],
    "benefitsDataSource": null,
    "views": 0,
    "expireAt": "2026-10-09T19:44:58.000Z",
    "new": false,
    "closedAt": "2026-10-02T18:35:56.000Z",
    "contentSource": "JOBS_PREMIUM_OFFLINE",
    "jobApplicationLimitReached": false,
    "applicantTrackingSystem": null
  },
  "query": {
    "jobId": "4465308031"
  },
  "status": 200,
  "retries": 0,
  "originalQuery": {
    "jobId": "4465308031"
  }
}
```

## Notes

- jobId is the number at the end of the LinkedIn job URL; the url also works.
- Flat per call. Usually one to three seconds.

## Siblings

- [`search_jobs`](https://parel.si/docs/tools/search_jobs.md) for many postings at once.
- [`get_linkedin_company`](https://parel.si/docs/tools/get_linkedin_company.md) for the employer.
