{ "openapi": "3.0.1", "info": { "title": "SiteVerdict Job Postings API: Greenhouse, Lever, Ashby +3", "description": "Get every open job from company careers boards on Greenhouse, Lever, Ashby, Workable, SmartRecruiters and Recruitee via their official public APIs. One clean schema: salary, remote, parsed locations. Auto-detect boards from careers URLs. Monitor new, changed and closed jobs.", "version": "1.0", "x-build-id": "BsfRKabLAjYNSLYDC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/siteverdict~siteverdict-job-postings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-siteverdict-siteverdict-job-postings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/siteverdict~siteverdict-job-postings/runs": { "post": { "operationId": "runs-sync-siteverdict-siteverdict-job-postings", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/siteverdict~siteverdict-job-postings/run-sync": { "post": { "operationId": "run-sync-siteverdict-siteverdict-job-postings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "boards": { "title": "Job boards (URLs or identifiers)", "type": "array", "description": "One per line. Accepts ATS board URLs (boards.greenhouse.io/acme, job-boards.greenhouse.io/acme, jobs.lever.co/acme, jobs.eu.lever.co/acme, jobs.ashbyhq.com/acme, apply.workable.com/acme, careers.smartrecruiters.com/Acme, acme.recruitee.com), identifiers (greenhouse:acme, lever:acme, lever-eu:acme, ashby:acme, workable:acme, smartrecruiters:Acme, recruitee:acme), or a company careers-page URL with an embedded board (auto-detected).", "items": { "type": "string" } }, "discoverDomains": { "title": "Discover boards from company domains", "type": "array", "description": "Company websites (e.g. stripe.com). The Actor reads the homepage and careers pages (respecting robots.txt) to find which supported ATS board the company uses.", "default": [], "items": { "type": "string" } }, "probeAtsApis": { "title": "Probe ATS APIs when discovery finds no link", "type": "boolean", "description": "If the careers pages don't link to a board, try the domain name as a board slug on each supported ATS public API. Boards found this way are marked detected_by=probe in the SUMMARY record: check the company name.", "default": true }, "maxDiscoveryPages": { "title": "Max pages per domain (discovery)", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many pages per company website to check for an ATS link (homepage + careers pages).", "default": 6 }, "keywords": { "title": "Keywords (any)", "type": "array", "description": "Keep jobs matching any of these words or phrases (whole word, case-insensitive, * wildcard allowed, e.g. engineer*).", "default": [], "items": { "type": "string" } }, "keywordScope": { "title": "Search keywords in", "enum": [ "title_description", "title" ], "type": "string", "description": "Where keywords are searched. 'Title only' is faster on SmartRecruiters (no detail requests are needed to filter).", "default": "title_description" }, "excludeKeywords": { "title": "Exclude title keywords", "type": "array", "description": "Drop jobs whose title contains any of these (e.g. intern, senior).", "default": [], "items": { "type": "string" } }, "departments": { "title": "Departments / teams", "type": "array", "description": "Keep jobs whose department or team contains any of these (e.g. Engineering, Sales).", "default": [], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep jobs whose location contains any of these: city, region, country name or 2-letter code (e.g. London, California, Germany, GB). Use 'remote' for remote jobs.", "default": [], "items": { "type": "string" } }, "workplaceTypes": { "title": "Workplace type", "type": "array", "description": "Keep only these workplace types. When this filter is set, jobs whose workplace type is neither published nor detectable are excluded.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] }, "default": [] }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Keep only these normalised employment types.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "temporary", "internship", "volunteer", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract / freelance", "Temporary / fixed-term", "Internship / trainee", "Volunteer", "Other" ] }, "default": [] }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "type": "integer", "description": "Keep jobs first published in the last N days (falls back to the last-updated date when the ATS publishes no posting date). 0 = no limit.", "default": 0 }, "onlyWithSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Keep only jobs with a published (or parsed) salary.", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "Newest first. 0 = no limit.", "default": 0 }, "maxJobsTotal": { "title": "Max jobs in total", "minimum": 0, "type": "integer", "description": "Stop once this many rows have been output in this run. 0 = no limit. Your 'Max total charge' run setting is always respected too.", "default": 0 }, "descriptionFormat": { "title": "Job description", "enum": [ "both", "text", "html", "none" ], "type": "string", "description": "Which description fields to include. 'None' also skips SmartRecruiters detail requests (much faster for big boards).", "default": "both" }, "parseSalaryFromText": { "title": "Parse salary from description text", "type": "boolean", "description": "When the ATS has no structured salary, extract a pay range from the description text (e.g. pay-transparency paragraphs). Parsed values are flagged salary_source = parsed_text.", "default": true }, "greenhousePayTransparency": { "title": "Greenhouse: fetch pay-transparency ranges", "type": "boolean", "description": "One extra public API request per matching Greenhouse job to read structured pay ranges where the company publishes them. Slower on large boards.", "default": false }, "includeContacts": { "title": "Include published contacts", "type": "boolean", "description": "Off by default. When on, adds a contacts field with contact details the company itself published on the posting (SmartRecruiters posting creator name, Recruitee application mailbox). Only enable if you have a lawful basis to process this data.", "default": false }, "monitorMode": { "title": "Monitoring mode (new / changed / closed jobs)", "type": "boolean", "description": "Compare with the previous run that used the same state key and label each job NEW, CHANGED, UNCHANGED or CLOSED.", "default": false }, "monitorOutput": { "title": "Monitoring output", "enum": [ "changes", "all" ], "type": "string", "description": "What to output in monitoring mode.", "default": "changes" }, "emitBaselineOnFirstRun": { "title": "Output all jobs on the first monitoring run", "type": "boolean", "description": "On the first run for a board there is nothing to compare with. On = output every job as NEW. Off = silently save a baseline and only report changes from the next run.", "default": true }, "includeClosed": { "title": "Report closed jobs", "type": "boolean", "description": "Output a CLOSED row for jobs that were on the board last run but are gone now. Closures are only reported for boards fetched successfully and completely.", "default": true }, "monitorStateKey": { "title": "State key", "type": "string", "description": "Give each monitor its own key (letters, digits, - and _). Changing filters automatically starts a fresh baseline.", "default": "default" }, "stateStoreName": { "title": "State key-value store name", "type": "string", "description": "Named key-value store that keeps monitoring state between runs.", "default": "siteverdict-job-postings-state" }, "maxConcurrency": { "title": "Boards in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many company boards to fetch at the same time. Requests to each ATS host are also throttled politely.", "default": 4 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 180, "type": "integer", "description": "Timeout for each HTTP request.", "default": 30 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 8, "type": "integer", "description": "Retries on network errors, timeouts, HTTP 429 and 5xx, with exponential backoff and Retry-After support.", "default": 3 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }