{ "openapi": "3.0.1", "info": { "title": "ATS Job Feeds: Greenhouse, Lever, Ashby, Workable & more", "description": "Normalized job postings from company job boards on Greenhouse, Lever, Ashby, SmartRecruiters, Workable and Recruitee. Paste career-page URLs; get one clean schema with salary, remote, locations and dates. Only-new mode tracks changes between runs.", "version": "1.0", "x-build-id": "MLxeicqh4PvUswR40" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chatuporn~ats-job-feeds/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chatuporn-ats-job-feeds", "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/chatuporn~ats-job-feeds/runs": { "post": { "operationId": "runs-sync-chatuporn-ats-job-feeds", "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/chatuporn~ats-job-feeds/run-sync": { "post": { "operationId": "run-sync-chatuporn-ats-job-feeds", "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", "required": [ "companies" ], "properties": { "companies": { "title": "Companies", "type": "array", "description": "One company per line. Paste a job-board URL (boards.greenhouse.io/x, jobs.lever.co/x, jobs.ashbyhq.com/x, careers.smartrecruiters.com/x, apply.workable.com/x, x.recruitee.com), write 'ats:token' (e.g. greenhouse:airbnb, lever:spotify, ashby:openai), paste the company's own careers page (the Actor looks for an embedded board), or just a name (every ATS is tried).", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep jobs that contain at least one of these words or phrases. Whole words, case-insensitive: 'java' does not match 'javascript'. Leave empty for all jobs.", "items": { "type": "string" } }, "keywordsMatch": { "title": "Search keywords in", "enum": [ "titleAndDescription", "title" ], "type": "string", "description": "Where to look for the keywords. 'Title and description' also checks department and team. On SmartRecruiters the board's own search is used for descriptions.", "default": "titleAndDescription" }, "excludeKeywords": { "title": "Exclude titles containing", "type": "array", "description": "Drop jobs whose title contains any of these words (whole words, case-insensitive), e.g. senior, intern, manager.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep jobs in at least one of these places, matched as whole words against the job's locations and country, e.g. London, Germany, US, New York. Add 'Remote' to also keep remote jobs anywhere.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only jobs the ATS marks as remote (or whose location says Remote). Hybrid jobs are not remote.", "default": false }, "departments": { "title": "Departments or teams", "type": "array", "description": "Keep jobs whose department or team contains one of these texts (case-insensitive), e.g. Engineering, Sales, Data.", "items": { "type": "string" } }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Keep only these employment types. Jobs whose ATS does not state a type are dropped when this is set.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "internship", "temporary" ], "enumTitles": [ "Full-time", "Part-time", "Contract / freelance", "Internship / working student", "Temporary / fixed-term" ] } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Keep jobs first published in the last N days. Jobs without a published date are kept. Leave empty for any age." }, "onlyNew": { "title": "Only jobs not seen in earlier runs", "type": "boolean", "description": "Remember every job ID per company (in the named key-value store 'ats-job-feeds-state' in your account) and return only jobs that appeared since the last run. The first run returns all current jobs. Use with a schedule for a new-jobs feed.", "default": false }, "includeDescription": { "title": "Include job description", "type": "boolean", "description": "Add the full job description. On SmartRecruiters this takes one extra request per job, so it is slower there.", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "markdown", "html" ], "type": "string", "description": "Plain text, light Markdown (headings, bold, lists, links) or the original HTML from the ATS.", "default": "text" }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "Return at most this many jobs per company, newest first. 0 means no limit. With 'Only new' on, jobs over the limit are returned in a later run.", "default": 0 } } }, "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 } } } } } } } } } }