Skip to the content
EnrichedNowDocs

    Type to search every page.

    Scraper · Careers and job boards

    careers.company

    Job openings from a company's own careers site: give its domain or its careers page.

    Id
    careers.company
    Version
    1
    Billed per
    request — 1 unit for a charged run
    Runs
    in the background; use wait or poll

    Start it with POST /v1/scrapers/careers.company/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 careers.company
    FieldTypeDescription
    domainstringThe company's website domain, e.g. acme.com.Limit: at most 253 characters.
    careers_urlstringThe company's careers page, when known.Limit: at most 2000 characters.
    company_namestringHelps tell the company's own board from another's.Limit: at most 200 characters.
    max_detail_pagesintegerPosting pages read for details, at most.Limit: 0 to 200. Default: 30.
    • Give exactly one of domain and careers_url. Both, or neither, is refused with invalid_input.
    • domain is a public host name such as acme.com; a bare site address such as https://acme.com/ is taken for its host. careers_url may be written without the scheme (acme.com/careers).
    • Neither may be an IP address, a name that only resolves inside a network (localhost, .local, .internal and the like), or an address that carries a login.
    • company_name is null on the records unless you give one or the company's job feed carries it.
    • The scraper finds the careers page itself. It can pick the wrong page — check diagnostics.facts.careers_url on the run, and pass careers_url yourself when you know it.
    • Every record says how it was obtained. extraction is ats when it came from the feed or board of an applicant tracking system we recognise (ats names the system): the employer's own list. It is page when we read it off the company's own pages (ats is generic): unverified, and it may be a page that is not a job posting.
    • A run whose records are all page records ends partial with the reason unverified_page_extraction. A run with at least one ats record ends ok; filter on extraction if you want only those.
    • Page records that are evidently not postings — a department heading, a handbook or product page, a list of search results — are dropped. When that leaves nothing, the run ends failed with the reason no_postings_recognised and costs nothing: it is not reported as a company with no openings.

    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 careers.company
    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.
    extraction"ats" | "page"How the record was obtained. "ats": from the feed or structured board of a recognised applicant-tracking system (ats names it) - the employer's own list. "page": read by our generic page reader from the company's own pages (ats is "generic") - unverified: it may be a page that is not a job posting.

    Example request

    Shell
    curl -X POST "https://api.enrichednow.com/v1/scrapers/careers.company/runs?wait=60" \
      -H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"input":{"domain":"acme.com"}}'

    The body on its own:

    JSON
    {
      "input": {
        "domain": "acme.com"
      }
    }

    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": "careers.company",
      "scraper_version": 1,
      "status": "ok",
      "reason": null,
      "input": {
        "domain": "acme.com"
      },
      "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": "Senior Software Engineer",
          "company_name": null,
          "company_domain": "acme.com",
          "location": {
            "raw": "Austin, TX",
            "city": "Austin",
            "region": "TX",
            "country": "United States",
            "remote": false
          },
          "employment_type": "Full-time",
          "posted_at": "2026-11-03",
          "valid_through": null,
          "salary": {
            "raw": "$120,000 – $150,000 a year",
            "min": 120000,
            "max": 150000,
            "currency": "USD",
            "period": "year"
          },
          "description": "We are looking for an engineer to work on our ingestion pipeline…",
          "apply_url": "https://jobs.ashbyhq.com/acme/1b2c3d4e/application",
          "page_url": "https://jobs.ashbyhq.com/acme/1b2c3d4e",
          "ats": "ashby",
          "external_id": "1b2c3d4e",
          "fetched_at": "2026-11-17T09:30:01Z",
          "extraction": "ats"
        }
      ],
      "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 Careers and job boards scrapers are in their own section there.