Skip to the content
EnrichedNowDocs

    Type to search every page.

    Scraper · LinkedIn

    linkedin.job

    One LinkedIn job posting's public details: give its address or its id.

    Id
    linkedin.job
    Version
    1
    Billed per
    request — 1 unit for a charged run
    Runs
    within one request

    Start it with POST /v1/scrapers/linkedin.job/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.job
    FieldTypeDescription
    urlstringThe posting's address, e.g. https://www.linkedin.com/jobs/view/plant-manager-at-acme-4487824457.Limit: at most 1000 characters.
    job_idstringThe posting's numeric id, when known.Limit: matches ^[0-9]{6,20}$.
    • Give exactly one of url and job_id. Both, or neither, is refused with invalid_input. url must be a posting's address on linkedin.com (/jobs/view/…).
    • It reads the posting's public page, as a visitor who is not signed in sees it.
    • apply_url is always null: LinkedIn keeps the apply link behind a sign-in.
    • posted_at is null: the page gives only a relative age, returned as LinkedIn wrote it in posted_ago. The date is on the search result — see [linkedin.jobs_search](/scrapers/linkedin.jobs_search/).
    • salary.raw is the pay as LinkedIn shows it, when it shows any. It is not split into a range.
    • Names and profile links of recruiters or hiring managers on the page are personal data and are not returned.
    • A posting LinkedIn says does not exist ends the run failed with the reason not_found, and costs nothing.

    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.job
    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.job/runs?wait=60" \
      -H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"input":{"url":"https://www.linkedin.com/jobs/view/plant-manager-at-acme-4487824457"}}'

    The body on its own:

    JSON
    {
      "input": {
        "url": "https://www.linkedin.com/jobs/view/plant-manager-at-acme-4487824457"
      }
    }

    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.job",
      "scraper_version": 1,
      "status": "ok",
      "reason": null,
      "input": {
        "url": "https://www.linkedin.com/jobs/view/plant-manager-at-acme-4487824457"
      },
      "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": "Full-time",
          "posted_at": null,
          "valid_through": null,
          "salary": {
            "raw": "$110,000.00/yr - $135,000.00/yr",
            "min": null,
            "max": null,
            "currency": null,
            "period": null
          },
          "description": "Acme is looking for a Plant Manager to lead day-to-day operations at our Houston facility…",
          "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": "2416891",
          "posted_ago": "2 days ago",
          "seniority_level": "Mid-Senior level",
          "job_function": "Management and Manufacturing",
          "industries": "Machinery Manufacturing",
          "applicants": "Be among the first 25 applicants",
          "accepting_applications": true,
          "description_html": "<p>Acme is looking for a Plant Manager to lead day-to-day operations at our Houston facility…</p>"
        }
      ],
      "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.