LinkedIn job search API
Job ads from LinkedIn Jobs, newest-relevant first as LinkedIn orders them, 10 a page: id, URL, title, company (name, handle, logo), location, the day it...
GET /v1/linkedin/jobs/search
GET /v1/linkedin/jobs/search
Job ads from LinkedIn Jobs, newest-relevant first as LinkedIn orders them, 10 a page: id, URL, title, company (name, handle, logo), location, the day it was posted and, when the card shows them, the pay range and a badge such as "Actively Hiring". Filter by words, place, how recently it was posted and company. Remote, hybrid or on-site, experience level and job type are not offered: LinkedIn ignores those filters for this search and does not print workplace type on the job. Employment type, seniority, function, industry, applicants and the description come from linkedin.job. The cursor runs to page 100 (about 1,000 jobs). A search with no match can still return LinkedIn's nearest jobs, so check the titles.
- Cost: 1 credit
- Cache: Results are kept up to 1 day; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Job title, skill or other words, as typed into LinkedIn's job search. Also accepted as keyword, q. |
location | string | no | Place as free text: a country, region or city ("United States", "Berlin"). |
date_posted | string | no | Only jobs posted in this window. One of hour, day, week, month. Also accepted values: past-hour for hour, past-24h for day, past-week for week, past-month for month, last-hour for hour, last-day for day, last-week for week, last-month for month. |
company_id | string | no | Only this company's jobs: LinkedIn's numeric company id (the id from linkedin.company, or a job's company.id), several separated by commas. Also accepted as companyId. |
Every request also accepts:
cursor: the cursor from the previous page (Pagination).trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request
Set your key in the environment first (see Authentication).
curl -G "https://api.socialscrape.dev/v1/linkedin/jobs/search" \ -H "x-api-key: $SOCIALSCRAPE_API_KEY" \ --data-urlencode "query=haskell" \ --data-urlencode "location=Iceland"
import os
import requests
params = {
"query": "haskell",
"location": "Iceland",
}
res = requests.get(
"https://api.socialscrape.dev/v1/linkedin/jobs/search",
headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},
params=params,
)
body = res.json()
if body["ok"]:
print(body["data"])
else:
print(body["error"]["code"], body["error"]["message"])
const url = new URL("https://api.socialscrape.dev/v1/linkedin/jobs/search"); url.search = new URLSearchParams({ "query": "haskell", "location": "Iceland" }).toString(); const res = await fetch(url, { headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! }, }); const body = await res.json(); if (body.ok) { console.log(body.data); } else { console.error(body.error.code, body.error.message); }
{
"nodes": [
{
"name": "SocialScrape LinkedIn job search",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
0,
0
],
"parameters": {
"method": "GET",
"url": "https://api.socialscrape.dev/v1/linkedin/jobs/search",
"sendQuery": true,
"queryParameters": {
"parameters": [
{
"name": "query",
"value": "haskell"
},
{
"name": "location",
"value": "Iceland"
}
]
},
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "x-api-key",
"value": "={{ $env.SOCIALSCRAPE_API_KEY }}"
}
]
}
}
}
],
"connections": {}
}
Example response
This is a sample from a recorded response, lists and long text are shortened. Status 200.
{
"ok": true,
"credits_charged": 1,
"credits_remaining": 4999,
"cached": false,
"cached_at": null,
"request_id": "req_f656c94628164e4eafb08407",
"data": {
"object": "list",
"items": [
{
"object": "job_posting",
"platform": "linkedin",
"id": "4474579813",
"url": "https://www.linkedin.com/jobs/view/4474579813",
"title": "Account Executive - Portfolio",
"company": {
"id": null,
"handle": "cisco",
"name": "Cisco",
"url": "https://www.linkedin.com/company/cisco",
"avatar_url": "https://media.licdn.com/dms/image/v2/D560BAQFYnR_Zrm87Dg/company-logo_100_100/B56ZnMyVr4HUAQ-/0/1760077372453/cisco_logo?e=2147483647&v=beta&t=-FnJBwOSzJBs2mZI3Vt8hsrLNZhBuwEXpMas5hClACE",
"verified": null
},
"location": "Reykjavík, Capital Region, Iceland",
"description": null,
"employment_type": null,
"seniority": null,
"job_function": null,
"industry": null,
"salary": null,
"applicant_count": null,
"published_at": "2026-11-13T00:00:00Z",
"approximate": [
"published_at"
],
"extra": {
"badge": "Actively Hiring",
"posted_text": "4 days ago"
}
},
{
"object": "job_posting",
"platform": "linkedin",
"id": "4486828688",
"url": "https://www.linkedin.com/jobs/view/4486828688",
"title": "Director Finance, Fish",
"company": {
"id": null,
"handle": "jbtmarel",
"name": "JBT Marel",
"url": "https://www.linkedin.com/company/jbtmarel",
"avatar_url": "https://media.licdn.com/dms/image/v2/D4D0BAQGptuQ1S7Jx9g/company-logo_100_100/company-logo_100_100/0/1736163017847/jbtmarel_logo?e=2147483647&v=beta&t=HVRjSV6SGdnI-Vtm1pLJMap7f9OdWc-_2ZRrxf2-l9g",
"verified": null
},
"location": "Garðabær, Capital Region, Iceland",
"description": null,
"employment_type": null,
"seniority": null,
"job_function": null,
"industry": null,
"salary": null,
"applicant_count": null,
"published_at": "2026-11-03T00:00:00Z",
"approximate": [
"published_at"
],
"extra": {
"badge": "Be an early applicant",
"posted_text": "2 weeks ago"
}
}
],
"cursor": null,
"has_more": false,
"parent": null
},
"cursor": null,
"has_more": false
}
Response
A list of JobPosting objects in data.items, with data.cursor and data.has_more.
See Data models for every field. The envelope around data is described in Responses.
Errors
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints
- LinkedIn Ad Library search (
GET /v1/linkedin/ad-library/search) - LinkedIn Ad Library ad details (
GET /v1/linkedin/ad-library/ad) - LinkedIn public person profile (
GET /v1/linkedin/profile) - LinkedIn company page (
GET /v1/linkedin/company) - LinkedIn company posts (
GET /v1/linkedin/company/posts) - LinkedIn job posting (
GET /v1/linkedin/job) - LinkedIn post search (
GET /v1/linkedin/search/posts) - LinkedIn public post (
GET /v1/linkedin/post)