Scraper · LinkedIn
linkedin.jobs_search
Job postings from LinkedIn's public job search: keywords, a place, and how recently they were listed.
- Id
linkedin.jobs_search- Version
- 1
- Billed per
- record — 1 unit for each record of a charged run
- Runs
- in the background; use wait or poll
Start it with POST /v1/scrapers/linkedin.jobs_search/runs. How runs work is in Running a scraper; what a run costs is in Usage and units.
Inputs
The fields of input. A field that is not listed here is refused.
| Field | Type | Description |
|---|---|---|
keywords | string | Words to search for, e.g. a job title. May be empty when a place is given.Limit: at most 200 characters. Default: "". |
location | string | A place as text, e.g. "Texas" or "United States".Limit: at most 200 characters. |
geo_id | string | LinkedIn's numeric geoId for the place; more exact than text.Limit: matches ^[0-9]{1,20}$. |
posted_within_hours | integer | Only postings listed in the last this many hours.Limit: 1 to 720. |
max_results | integer | Postings returned, at most (LinkedIn serves 1,000 a search).Limit: 1 to 1000. Default: 25. |
- Give at least one of
keywords,locationandgeo_id. An input with none of them is refused withinvalid_input. - It reads LinkedIn's public job search, as a visitor who is not signed in sees it. Nothing behind a sign-in is read.
- A record is what a search result shows: the title, the company, the location, the date it was listed and the posting's address.
description,employment_type,seniority_leveland the other details arenullhere. Run [linkedin.job](/scrapers/linkedin.job/) on a posting to get them. - LinkedIn serves at most 1,000 results for one search. To reach more postings, narrow the search with a place or with
posted_within_hoursand run it several times. - Only what the logged-out search honours is an input. It ignores LinkedIn's job-type, workplace and experience filters, so they are not offered.
- Billed per record: a charged run costs 1 unit for each posting it returns.
max_resultsbounds that. - When LinkedIn refuses a page part-way through, the run ends
partialwith the postings read before it. An empty result isokonly when LinkedIn answered with its own empty page.
Record fields
Every record of a run has these fields. A value that is not known is null — never an empty string and never 0.
| Field | Type | Notes |
|---|---|---|
title | string | Always present. |
company_name | string or null | null when not known. |
company_domain | string or null | null when not known. |
location | object or null | null when not known. |
raw (in location) | string or null | null when not known. |
city (in location) | string or null | null when not known. |
region (in location) | string or null | null when not known. |
country (in location) | string or null | null when not known. |
remote (in location) | boolean or null | null when not known. |
employment_type | string or null | null when not known. |
posted_at | string (date) or null | null when not known. |
valid_through | string (date) or null | null when not known. |
salary | object or null | null when not known. |
raw (in salary) | string or null | null when not known. |
min (in salary) | number or null | null when not known. |
max (in salary) | number or null | null when not known. |
currency (in salary) | string or null | null when not known. |
period (in salary) | string or null | null when not known. |
description | string or null | null when not known. |
apply_url | string or null | null when not known. |
page_url | string | Always present. |
ats | string or null | null when not known. |
external_id | string or null | null when not known. |
fetched_at | string (date-time) | Always present. |
company_linkedin_url | string or null | null when not known. |
company_linkedin_id | string or null | null when not known. |
posted_ago | string or null | null when not known. |
seniority_level | string or null | null when not known. |
job_function | string or null | null when not known. |
industries | string or null | null when not known. |
applicants | string or null | null when not known. |
accepting_applications | boolean or null | null when not known. |
description_html | string or null | null when not known. |
Example request
curl -X POST "https://api.enrichednow.com/v1/scrapers/linkedin.jobs_search/runs?wait=60" \
-H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"keywords":"plant manager","location":"Texas","posted_within_hours":24,"max_results":25}}'The body on its own:
{
"input": {
"keywords": "plant manager",
"location": "Texas",
"posted_within_hours": 24,
"max_results": 25
}
}Example response
The run, once it has ended. A run that has not ended within wait comes back with 202 and the status queued or running.
{
"id": "run_6cce2b12aaf37a10b5e1b885",
"scraper_id": "linkedin.jobs_search",
"scraper_version": 1,
"status": "ok",
"reason": null,
"input": {
"keywords": "plant manager",
"location": "Texas",
"posted_within_hours": 24,
"max_results": 25
},
"record_count": 1,
"units": 1,
"diagnostics": {
"requests": 1,
"bytes": 232779,
"wall_ms": 565,
"facts": {}
},
"created_at": "2026-11-16T20:27:29.009834Z",
"started_at": "2026-11-16T20:27:29.013803Z",
"finished_at": "2026-11-16T20:27:29.582787Z"
}Its records, from GET /v1/runs/{id}/records (the values are an illustration; the fields are the ones above):
{
"records": [
{
"title": "Plant Manager",
"company_name": "Acme",
"company_domain": null,
"location": {
"raw": "Houston, TX",
"city": null,
"region": null,
"country": null,
"remote": null
},
"employment_type": null,
"posted_at": "2026-11-16",
"valid_through": null,
"salary": null,
"description": null,
"apply_url": null,
"page_url": "https://www.linkedin.com/jobs/view/plant-manager-at-acme-4487824457",
"ats": null,
"external_id": "4487824457",
"fetched_at": "2026-11-17T09:30:01Z",
"company_linkedin_url": "https://www.linkedin.com/company/acme",
"company_linkedin_id": null,
"posted_ago": "18 hours ago",
"seniority_level": null,
"job_function": null,
"industries": null,
"applicants": null,
"accepting_applications": null,
"description_html": null
}
],
"next_cursor": null
}A run does not always end ok. Results and statuses lists every status and the reasons every scraper shares; the reasons of the LinkedIn scrapers are in their own section there.