Skip to the content
EnrichedNowDocs

    Type to search every page.

    Scraper · Careers and job boards

    ats.board

    Job openings from one board of an applicant tracking system (Greenhouse, Lever, Ashby, Workday and others).

    Id
    ats.board
    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/ats.board/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 ats.board
    FieldTypeDescription
    board_urlrequiredstringThe board's address, e.g. https://boards.greenhouse.io/acme.Limit: at most 2000 characters.
    company_namestringThe employer's name, when the board does not give it.Limit: at most 200 characters.
    max_detail_pagesintegerPosting pages read for details, at most.Limit: 0 to 200. Default: 30.
    • The address must be a board of an applicant tracking system we recognise. Any other address ends the run as unsupported with the reason unknown_board, before a single request is made.
    • Dayforce boards are drawn entirely by JavaScript and end as unsupported with the reason render_required.
    • board_url must be a full http or https address on a public host name, with no login in it.
    • A board's own host (boards.greenhouse.io) is never reported as the employer's domain: company_domain is null when the employer's domain is not known.
    • extraction is ats on a record the board's own feed or listing gave. If the board's page had to be read as a plain page instead, its records say page and the run does not end as a plain ok: see [the reasons of this family](/results-and-statuses/#careers-and-job-boards).

    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 ats.board
    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/ats.board/runs?wait=60" \
      -H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"input":{"board_url":"https://boards.greenhouse.io/acme"}}'

    The body on its own:

    JSON
    {
      "input": {
        "board_url": "https://boards.greenhouse.io/acme"
      }
    }

    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": "ats.board",
      "scraper_version": 1,
      "status": "ok",
      "reason": null,
      "input": {
        "board_url": "https://boards.greenhouse.io/acme"
      },
      "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": "Acme",
          "company_domain": null,
          "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": null,
          "description": "We are looking for an engineer to work on our ingestion pipeline…",
          "apply_url": "https://boards.greenhouse.io/acme/jobs/4567890",
          "page_url": "https://boards.greenhouse.io/acme/jobs/4567890",
          "ats": "greenhouse",
          "external_id": "4567890",
          "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.