# LinkedIn Job API. Send a job link or ID.

Job posting with pay, applicants and hiring team. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dlinkedin.job)

[In your agent: **LinkedIn MCP server** →](https://socialtap.dev/mcp/linkedin/index.md)

## LinkedIn Job API at a glance

Returns one LinkedIn job posting from its link or ID. You get the title, the company with its ID, the full description, the location split into city, region and country, the pay range, seniority, employment type, industries, the applicant count, whether it is closed or Easy Apply, and the hiring team with their profile links.

GET `/v1/linkedin/job`

[Read the API reference](https://socialtap.dev/docs/reference/linkedin/job/index.md)

- **1 credit** per request, $0.75–$1.97 per 1,000 requests
- **23 typed fields** null when unknown
- **`url`** is all it needs, e.g. `https://www.linkedin.com/jobs/view/4455904267/`
- **100 credits** free when you sign up, no card, so you can build before you spend

## Send one request. Get 23 fields back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

`$ npm install socialtap`

`url = https://www.linkedin.com/jobs/view/4455904267/`

[Open in playground](https://socialtap.dev/playground/?endpoint=linkedin.job)

cURL:

```shell
curl -G 'https://socialtap.dev/v1/linkedin/job' \
  --data-urlencode 'url=https://www.linkedin.com/jobs/view/4474717422/' \
  -H "x-api-key: $SOCIALTAP_API_KEY"
```

TypeScript SDK:

```typescript
import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.linkedin.job.get({ url: "https://www.linkedin.com/jobs/view/4474717422/" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  url: "https://www.linkedin.com/jobs/view/4474717422/",
});
const res = await fetch(`https://socialtap.dev/v1/linkedin/job?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/linkedin/job",
    params={"url": "https://www.linkedin.com/jobs/view/4474717422/"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])
```

Go (net/http):

```go
package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("url", "https://www.linkedin.com/jobs/view/4474717422/")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/linkedin/job?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}
```

200 OK:

```json
{
  "data": {
    "apply_url": null,
    "approximate_fields": [
      "published_at"
    ],
    "benefits": [],
    "description": "Founding Systems Engineer/Full Stack | Founding Team | London\n\nFully Funded\n\nSalary up to £200k - Will go higher\n\nHybrid/Onsite\n\nEquity\n\nBonus\n\nI’m working with an early-stage AI company that is building a new type of technology-driven operating business.\n\nThey’ve grown rapidly s…",
    "employer": {
      "avatar_url": "https://media.licdn.com/dms/image/v2/D4E0BAQEi30ccaj_HaQ/company-logo_100_100/B4EZd90ng1H0AQ-/0/1750162635378/w_talentuk_logo?e=2147483647&v=beta&t=seXSwQEqehLT4Sb0bdI9wiNhNWlu3HCMFh1U-V5qRQs",
      "display_name": "W Talent",
      "id": "101505162",
      "is_verified": null,
      "url": "https://www.linkedin.com/company/w-talentuk",
      "username": "w-talentuk"
    },
    "employment_types": [
      "full_time"
    ],
    "expires_at": null,
    "id": "4474717422",
    "industries": [
      "Financial Services",
      "Technology, Information and Media"
    ],
    "is_closed": false,
    "is_easy_apply": true,
    "job_functions": [],
    "locations": [
      {
        "city": null,
        "country_code": "GB",
        "name": "London Area, United Kingdom",
        "region": null
      }
    ],
    "metrics": {
      "applicant_count": 123
    },
    "platform": "linkedin",
    "platform_specific": {
      "linkedin": {
        "hiring_team": [
          {
            "avatar_url": "https://media.licdn.com/dms/image/v2/D4E03AQFZneQshJWZ3w/profile-displayphoto-scale_400_400/B4EZxzCTO6JgAg-/0/1771456510083?e=2147483647&v=beta&t=hha5XyQyt0rD-BqB7P4KaOgg3Jridna4J2GpWBLbyHk",
            "display_name": "Karl Ramsaran",
            "id": null,
            "is_verified": null,
            "url": "https://www.linkedin.com/in/karl-ramsaran-bb442815",
            "username": "karl-ramsaran-bb442815"
          }
        ],
        "industry_ids": [
          "43",
          "1594"
        ],
        "title_id": null
      }
    },
    "published_at": "2026-10-30T00:00:00Z",
    "salary": null,
    "seniority": "Mid-Senior level",
    "skills": [],
    "title": "Founding Systems Engineer",
    "unknown_fields": [
      "job_functions",
      "skills",
      "benefits"
    ],
    "url": "https://www.linkedin.com/jobs/view/4474717422/",
    "workplace_type": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "linkedin",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 1000,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "job",
      "id": "4474717422",
      "url": "https://www.linkedin.com/jobs/view/4474717422/"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 2 platforms.

The [response reference](https://socialtap.dev/docs/reference/linkedin/job/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/job/index.md).

- ### Null means unknown

  A field LinkedIn doesn't show is null, never zero or an empty string, so a real zero always means zero.
- ### What it accepts

  A LinkedIn job: its link (linkedin.com/jobs/view/\<id>, with or without the title in it), a job search or collection link with the job open (?currentJobId=\<id>), or its ID alone.
- ### Write one parser

  LinkedIn and Hacker News answer in these fields, so the code that reads one reads them all.

- **`platform`string**: Platform ID (linkedin, …).
- **`id`string**: Platform-native job ID (string; LinkedIn's numeric job ID).
- **`url`string**: Canonical job page URL (https://www.linkedin.com/jobs/view/\<id>/).
- **`title`string**: The job's title as the employer wrote it.
- **`employer`object**: The company (or person) hiring, as the board names it: its account on the platform when it has one; null when the board does not say who is hiring (a confidential posting, an Upwork client).
- **`description`string**: The full description as plain text, line breaks kept (paragraphs and list items each on their own line); null when the board shows none.
- **`locations`object\[\]**: Where the job is based, the main location first, as the board shows them; \[\] when none is shown (a remote job with no location), listed in unknown_fields when the source cannot see them.
- **`workplace_type`string**: Where the work is done: on_site, hybrid (partly remote) or remote; null when the board does not say. New values may be added; treat unknown values as null.

Live data from 35 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [GitHub](https://socialtap.dev/apis/github/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Hacker News](https://socialtap.dev/apis/hackernews/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/page/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/profile/index.md) · [Linkme](https://socialtap.dev/apis/linkme/profile/index.md) · [Linktree](https://socialtap.dev/apis/linktree/profile/index.md) · [Pillar](https://socialtap.dev/apis/pillar/page/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## What teams build with the LinkedIn Job API.

- ### Track a company's open roles and pay ranges
- ### Enrich job links with full descriptions
- ### Find the recruiter behind a posting
- ### Watch when a job closes

## Good to know before you build.

- published_at comes from LinkedIn's age label ("2 weeks ago"), so it is approximate: the latest time the label allows. The job may have been posted up to one of the label's units earlier: a week for "2 weeks ago", a month for "3 months ago", an hour for "5 hours ago".
- The applicant count is exact below LinkedIn's cap and its lower bound above it ("Over 200 applicants"); it is null while LinkedIn only says "Be among the first 25 applicants".
- apply_url, workplace_type, skills, benefits and job functions are null or empty because LinkedIn shows them only to signed-in members.
- The hiring team is listed only when the poster chose to show it, which is more common at small companies than large ones.

## 1 credit per request. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/linkedin/job/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful request | Per 1,000 requests |
| --- | --- | --- |
| Platform API `api` | 1 credit | $0.75–$1.97 |
| Public page `page` | 1 credit | $0.75–$1.97 |

- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

## Questions about the LinkedIn Job API.

More in the [API reference](https://socialtap.dev/docs/reference/linkedin/job/index.md).

**Where do I find a job's ID?**

At the end of its link: linkedin.com/jobs/view/4455904267 has the ID 4455904267. A search link with a job open carries it as currentJobId.

**Does it return jobs that are closed?**

Yes. A closed job keeps its description and details, with is_closed true. A job LinkedIn removed returns not_found.

**How much does the LinkedIn Job API cost?**

A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

Other platforms

## Jobs on 1 more platform.

- [Hacker News Who Is Hiring API](https://socialtap.dev/apis/hackernews/whoishiring-jobs/index.md) (1 credit / page · `GET /v1/hackernews/whoishiring_jobs`)

More LinkedIn

## LinkedIn API. 19 endpoints, one key.

- [LinkedIn Post API](https://socialtap.dev/apis/linkedin/post/index.md) (1 credit · `GET /v1/linkedin/post`)
- [LinkedIn Posts API](https://socialtap.dev/apis/linkedin/posts/index.md) (From 1 credit / page · `GET /v1/linkedin/posts`)
- [LinkedIn Reposts API](https://socialtap.dev/apis/linkedin/post-reposts/index.md) (From 1 credit / page · `GET /v1/linkedin/post_reposts`)
- [LinkedIn Reactions API](https://socialtap.dev/apis/linkedin/liked-posts/index.md) (From 1 credit / page · `GET /v1/linkedin/liked_posts`)
- [LinkedIn Profile API](https://socialtap.dev/apis/linkedin/profile/index.md) (From 1 credit · `GET /v1/linkedin/profile`)
- [LinkedIn Employees API](https://socialtap.dev/apis/linkedin/employees/index.md) (5 credits / page · `GET /v1/linkedin/employees`)
- [LinkedIn Following API](https://socialtap.dev/apis/linkedin/following/index.md) (5 credits / page · `GET /v1/linkedin/following`)
- [LinkedIn Post Reactions API](https://socialtap.dev/apis/linkedin/post-reactions/index.md) (From 1 credit / page · `GET /v1/linkedin/post_reactions`)
- [LinkedIn Comments API](https://socialtap.dev/apis/linkedin/comments/index.md) (From 1 credit / page · `GET /v1/linkedin/comments`)
- [LinkedIn Profile Comments API](https://socialtap.dev/apis/linkedin/profile-comments/index.md) (10 credits / page · `GET /v1/linkedin/profile_comments`)
- [LinkedIn Video Transcript API](https://socialtap.dev/apis/linkedin/transcript/index.md) (From 1 credit · `GET /v1/linkedin/transcript`)
- [LinkedIn Post Search API](https://socialtap.dev/apis/linkedin/search-posts/index.md) (From 1 credit / page · `GET /v1/linkedin/search_posts`)
- [LinkedIn Company and People Search API](https://socialtap.dev/apis/linkedin/search-profiles/index.md) (From 1 credit / page · `GET /v1/linkedin/search_profiles`)
- [LinkedIn Engagement API](https://socialtap.dev/apis/linkedin/engagement/index.md) (From 1 credit · `GET /v1/linkedin/engagement`)
- [LinkedIn Profile Groups API](https://socialtap.dev/apis/linkedin/profile-groups/index.md) (5 credits / page · `GET /v1/linkedin/profile_groups`)
- [LinkedIn Job Search API](https://socialtap.dev/apis/linkedin/search-jobs/index.md) (1 credit / page · `GET /v1/linkedin/search_jobs`)
- [LinkedIn Similar Jobs API](https://socialtap.dev/apis/linkedin/job-related-jobs/index.md) (1 credit / page · `GET /v1/linkedin/job_related_jobs`)
- [LinkedIn Company Jobs API](https://socialtap.dev/apis/linkedin/jobs/index.md) (1 credit / page · `GET /v1/linkedin/jobs`)

## Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

100free credits

- No credit card
- Failed requests are free
- Works on all 276 endpoints

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/linkedin/job/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)
