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.
| Field | Type | Description |
|---|---|---|
domain | string | The company's website domain, e.g. acme.com.Limit: at most 253 characters. |
careers_url | string | The company's careers page, when known.Limit: at most 2000 characters. |
company_name | string | Helps tell the company's own board from another's.Limit: at most 200 characters. |
max_detail_pages | integer | Posting pages read for details, at most.Limit: 0 to 200. Default: 30. |
- Give exactly one of
domainandcareers_url. Both, or neither, is refused withinvalid_input. domainis a public host name such asacme.com; a bare site address such ashttps://acme.com/is taken for its host.careers_urlmay be written without the scheme (acme.com/careers).- Neither may be an IP address, a name that only resolves inside a network (
localhost,.local,.internaland the like), or an address that carries a login. company_nameisnullon 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_urlon the run, and passcareers_urlyourself when you know it. - Every record says how it was obtained.
extractionisatswhen it came from the feed or board of an applicant tracking system we recognise (atsnames the system): the employer's own list. It ispagewhen we read it off the company's own pages (atsisgeneric): unverified, and it may be a page that is not a job posting. - A run whose records are all
pagerecords endspartialwith the reasonunverified_page_extraction. A run with at least oneatsrecord endsok; filter onextractionif 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
failedwith the reasonno_postings_recognisedand 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.
| 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. |
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
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:
{
"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.
{
"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):
{
"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.