LinkedIn
LinkedIn job.search
Search LinkedIn job postings from a free-text query. Normalized JSON, one price per record, automatic failover across sources.
POST
/
v1
/
extract
/
linkedin
/
job.search
curl -X POST https://api.socialrouter.io/v1/extract/linkedin/job.search \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "product manager",
"limit": 50,
"options": {
"location": "Paris",
"timeRange": "Past 24 hours"
}
}'
const response = await fetch(
"https://api.socialrouter.io/v1/extract/linkedin/job.search",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "product manager",
limit: 50,
options: {
location: "Paris",
timeRange: "Past 24 hours"
}
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/extract/linkedin/job.search",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"query": "product manager",
"limit": 50,
"options": {
"location": "Paris",
"timeRange": "Past 24 hours"
}
},
)
const run = await sr.run("linkedin/job.search", {
query: "product manager",
limit: 50,
options: {
location: "Paris",
timeRange: "Past 24 hours"
}
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "linkedin",
"service": "job.search",
"query": "product manager",
"served_by": "brightdata/linkedin",
"data": [
{
"name": "Software Engineer",
"title": "Software Engineer",
"company": "Indiana University Bloomington",
"location": "Bloomington, IN",
"profile_url": "https://www.linkedin.com/jobs/view/software-engineer-at-indiana-university-bloomington-4452681725?_l=en",
"source": "linkedin",
"extracted_at": "2026-08-20T20:35:28.696Z",
"job_id": "4452681725",
"title_id": "9",
"country_code": "US",
"job_summary": "UITS SOFTWARE & NETWORK ENGINE (UA-NENG-IUBLA) At University Information Technology Services (UITS) we provide the te...",
"job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"20\">\n <div class=\"show-more-less-html__markup show-more-l...",
"job_seniority_level": "Not Applicable",
"job_function": "Information Technology",
"job_employment_type": "Full-time",
"job_industries": "Higher Education",
"job_num_applicants": 141,
"posted_date": "2026-08-13T20:35:07.675Z",
"job_posted_time": "1 week ago",
"job_posted_date": "2026-08-13T20:35:07.675Z",
"company_id": "3325",
"company_url": "https://www.linkedin.com/school/indiana-university-bloomington/?trk=public_jobs_topcard-org-name",
"company_logo": "https://media.licdn.com/dms/image/v2/C560BAQFonK534Iq8-Q/company-logo_100_100/company-logo_100_100/0/1631332394799?e=...",
"is_easy_apply": false,
"application_availability": true,
"discovery_keyword": "software engineer",
"discovery_location": "United States",
"discovery_country": "US",
"discovery_experience_level": "Mid-Senior level",
"discovery_job_type": "Full-time",
"discovery_remote": "Remote",
"discovery_time_range": "Past month",
"discovery_selective_search": true
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}
Search LinkedIn job postings from a free-text query. The response is normalized, so it keeps the same shape whichever offer served it.
The call is synchronous and comes back
Prices are live in the catalogue:
completed or failed. Body fields and error codes shared by every service are documented on Run a service.
Body
string[]
required
The search queries to run, as
queries (array) or query (single string). Free text, exactly as you would type it on LinkedIn.string
Single-input form of
queries.number
default:"100"
Maximum number of records to return. Integer, 1-250.
string
Pin one offer, as
source/name. Serving this service: brightdata/linkedin. Omit it (the default) to let the router walk the failover chain.object
Typed options for this service. Validation is strict, so an unknown key or an out-of-enum value returns a corrective
400 instead of being dropped.Hide options
Hide options
string
required
Where to search, as LinkedIn spells it: a city, region or country, e.g. “Paris”, “Greater London”, “United States”. LinkedIn scopes a job search to a place, so a keyword on its own is not a search.
string (ISO 3166-1 alpha-2)
Two-letter country code narrowing the location, e.g. “FR”, “US”.
enum
Only return listings posted within this window. One of:
Past 24 hours, Past week, Past month, Any time.enum
Employment type. One of:
Full-time, Part-time, Contract, Temporary, Internship, Volunteer, Other.enum
Seniority of the role. One of:
Internship, Entry level, Associate, Mid-Senior level, Director, Executive.enum
Work arrangement. One of:
Remote, On-site, Hybrid.string
Only return listings from this company.
string
How far around
location to search, in LinkedIn’s own units, e.g. “25 mi”.boolean
default:"false"
Drop listings whose title does not contain the keyword. Fewer results, tighter match, fewer billed records.
Accepted queries
A job title or keyword, as you would type it in LinkedIn’s job search. Example:product manager.
Quote a phrase (“product manager”) for an exact match. The location option is required: LinkedIn scopes a job search to a place.
Offers
One offer serves this endpoint today. When a second one implements it, failover turns on with no change on your side.| Offer | Inputs per call |
|---|---|
brightdata/linkedin | 100 |
GET /v1/services/linkedin/job.search. See Credits for how a call is billed.
Response
data[] holds the normalized records, served_by names the offer that answered, and credits_used carries the actual charge.
The example response is a real run with values shortened for readability. A field is present when LinkedIn exposes it for that item, so the exact set varies record to record.
curl -X POST https://api.socialrouter.io/v1/extract/linkedin/job.search \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "product manager",
"limit": 50,
"options": {
"location": "Paris",
"timeRange": "Past 24 hours"
}
}'
const response = await fetch(
"https://api.socialrouter.io/v1/extract/linkedin/job.search",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "product manager",
limit: 50,
options: {
location: "Paris",
timeRange: "Past 24 hours"
}
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/extract/linkedin/job.search",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"query": "product manager",
"limit": 50,
"options": {
"location": "Paris",
"timeRange": "Past 24 hours"
}
},
)
const run = await sr.run("linkedin/job.search", {
query: "product manager",
limit: 50,
options: {
location: "Paris",
timeRange: "Past 24 hours"
}
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "linkedin",
"service": "job.search",
"query": "product manager",
"served_by": "brightdata/linkedin",
"data": [
{
"name": "Software Engineer",
"title": "Software Engineer",
"company": "Indiana University Bloomington",
"location": "Bloomington, IN",
"profile_url": "https://www.linkedin.com/jobs/view/software-engineer-at-indiana-university-bloomington-4452681725?_l=en",
"source": "linkedin",
"extracted_at": "2026-08-20T20:35:28.696Z",
"job_id": "4452681725",
"title_id": "9",
"country_code": "US",
"job_summary": "UITS SOFTWARE & NETWORK ENGINE (UA-NENG-IUBLA) At University Information Technology Services (UITS) we provide the te...",
"job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"20\">\n <div class=\"show-more-less-html__markup show-more-l...",
"job_seniority_level": "Not Applicable",
"job_function": "Information Technology",
"job_employment_type": "Full-time",
"job_industries": "Higher Education",
"job_num_applicants": 141,
"posted_date": "2026-08-13T20:35:07.675Z",
"job_posted_time": "1 week ago",
"job_posted_date": "2026-08-13T20:35:07.675Z",
"company_id": "3325",
"company_url": "https://www.linkedin.com/school/indiana-university-bloomington/?trk=public_jobs_topcard-org-name",
"company_logo": "https://media.licdn.com/dms/image/v2/C560BAQFonK534Iq8-Q/company-logo_100_100/company-logo_100_100/0/1631332394799?e=...",
"is_easy_apply": false,
"application_availability": true,
"discovery_keyword": "software engineer",
"discovery_location": "United States",
"discovery_country": "US",
"discovery_experience_level": "Mid-Senior level",
"discovery_job_type": "Full-time",
"discovery_remote": "Remote",
"discovery_time_range": "Past month",
"discovery_selective_search": true
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}
⌘I
curl -X POST https://api.socialrouter.io/v1/extract/linkedin/job.search \
-H "Authorization: Bearer sr_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "product manager",
"limit": 50,
"options": {
"location": "Paris",
"timeRange": "Past 24 hours"
}
}'
const response = await fetch(
"https://api.socialrouter.io/v1/extract/linkedin/job.search",
{
method: "POST",
headers: {
"Authorization": "Bearer sr_live_your_key",
"Content-Type": "application/json",
},
body: JSON.stringify({
query: "product manager",
limit: 50,
options: {
location: "Paris",
timeRange: "Past 24 hours"
}
}),
},
);
import requests
response = requests.post(
"https://api.socialrouter.io/v1/extract/linkedin/job.search",
headers={"Authorization": "Bearer sr_live_your_key"},
json={
"query": "product manager",
"limit": 50,
"options": {
"location": "Paris",
"timeRange": "Past 24 hours"
}
},
)
const run = await sr.run("linkedin/job.search", {
query: "product manager",
limit: 50,
options: {
location: "Paris",
timeRange: "Past 24 hours"
}
});
{
"id": "ext_a1b2c3d4",
"status": "completed",
"platform": "linkedin",
"service": "job.search",
"query": "product manager",
"served_by": "brightdata/linkedin",
"data": [
{
"name": "Software Engineer",
"title": "Software Engineer",
"company": "Indiana University Bloomington",
"location": "Bloomington, IN",
"profile_url": "https://www.linkedin.com/jobs/view/software-engineer-at-indiana-university-bloomington-4452681725?_l=en",
"source": "linkedin",
"extracted_at": "2026-08-20T20:35:28.696Z",
"job_id": "4452681725",
"title_id": "9",
"country_code": "US",
"job_summary": "UITS SOFTWARE & NETWORK ENGINE (UA-NENG-IUBLA) At University Information Technology Services (UITS) we provide the te...",
"job_description_formatted": "<section class=\"show-more-less-html\" data-max-lines=\"20\">\n <div class=\"show-more-less-html__markup show-more-l...",
"job_seniority_level": "Not Applicable",
"job_function": "Information Technology",
"job_employment_type": "Full-time",
"job_industries": "Higher Education",
"job_num_applicants": 141,
"posted_date": "2026-08-13T20:35:07.675Z",
"job_posted_time": "1 week ago",
"job_posted_date": "2026-08-13T20:35:07.675Z",
"company_id": "3325",
"company_url": "https://www.linkedin.com/school/indiana-university-bloomington/?trk=public_jobs_topcard-org-name",
"company_logo": "https://media.licdn.com/dms/image/v2/C560BAQFonK534Iq8-Q/company-logo_100_100/company-logo_100_100/0/1631332394799?e=...",
"is_easy_apply": false,
"application_availability": true,
"discovery_keyword": "software engineer",
"discovery_location": "United States",
"discovery_country": "US",
"discovery_experience_level": "Mid-Senior level",
"discovery_job_type": "Full-time",
"discovery_remote": "Remote",
"discovery_time_range": "Past month",
"discovery_selective_search": true
}
],
"pagination": {
"total": 1,
"returned": 1
},
"created_at": "2026-07-30T12:00:00Z",
"completed_at": "2026-07-30T12:00:03Z"
}