Skip to the content
EnrichedNowDocs

    Type to search every page.

    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.

    Inputs of linkedin.jobs_search
    FieldTypeDescription
    keywordsstringWords to search for, e.g. a job title. May be empty when a place is given.Limit: at most 200 characters. Default: "".
    locationstringA place as text, e.g. "Texas" or "United States".Limit: at most 200 characters.
    geo_idstringLinkedIn's numeric geoId for the place; more exact than text.Limit: matches ^[0-9]{1,20}$.
    posted_within_hoursintegerOnly postings listed in the last this many hours.Limit: 1 to 720.
    max_resultsintegerPostings returned, at most (LinkedIn serves 1,000 a search).Limit: 1 to 1000. Default: 25.
    • Give at least one of keywords, location and geo_id. An input with none of them is refused with invalid_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_level and the other details are null here. 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_hours and 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_results bounds that.
    • When LinkedIn refuses a page part-way through, the run ends partial with the postings read before it. An empty result is ok only 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.

    Record fields of linkedin.jobs_search
    FieldTypeNotes
    titlestringAlways present.
    company_namestring or nullnull when not known.
    company_domainstring or nullnull when not known.
    locationobject or nullnull when not known.
    raw (in location)string or nullnull when not known.
    city (in location)string or nullnull when not known.
    region (in location)string or nullnull when not known.
    country (in location)string or nullnull when not known.
    remote (in location)boolean or nullnull when not known.
    employment_typestring or nullnull when not known.
    posted_atstring (date) or nullnull when not known.
    valid_throughstring (date) or nullnull when not known.
    salaryobject or nullnull when not known.
    raw (in salary)string or nullnull when not known.
    min (in salary)number or nullnull when not known.
    max (in salary)number or nullnull when not known.
    currency (in salary)string or nullnull when not known.
    period (in salary)string or nullnull when not known.
    descriptionstring or nullnull when not known.
    apply_urlstring or nullnull when not known.
    page_urlstringAlways present.
    atsstring or nullnull when not known.
    external_idstring or nullnull when not known.
    fetched_atstring (date-time)Always present.
    company_linkedin_urlstring or nullnull when not known.
    company_linkedin_idstring or nullnull when not known.
    posted_agostring or nullnull when not known.
    seniority_levelstring or nullnull when not known.
    job_functionstring or nullnull when not known.
    industriesstring or nullnull when not known.
    applicantsstring or nullnull when not known.
    accepting_applicationsboolean or nullnull when not known.
    description_htmlstring or nullnull when not known.

    Example request

    Shell
    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:

    JSON
    {
      "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.

    JSON
    {
      "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):

    JSON
    {
      "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.