{ "openapi": "3.0.1", "info": { "title": "ATS Jobs Feed: 350k+ Jobs from Greenhouse, Lever, Ashby", "version": "1.1", "x-build-id": "j7l2jdM8dX22M0O2O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/best_apis~ats-jobs-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-best_apis-ats-jobs-feed", "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/best_apis~ats-jobs-feed/runs": { "post": { "operationId": "runs-sync-best_apis-ats-jobs-feed", "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/best_apis~ats-jobs-feed/run-sync": { "post": { "operationId": "run-sync-best_apis-ats-jobs-feed", "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": { "mode": { "title": "Mode", "enum": [ "jobs", "changes", "companies" ], "type": "string", "description": "**jobs**: search open jobs. **changes**: jobs that were opened, closed or edited since the previous daily snapshot(s). **companies**: one hiring-signal record per company (open roles, 7/30-day activity, top functions, countries and skills).", "default": "jobs" }, "searchKeywords": { "title": "Keywords", "type": "array", "description": "Match jobs whose title, department, company name or extracted skills contain **any** of these terms (case-insensitive). In companies mode they match the company name. Leave empty for no keyword filter.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title or department contains any of these terms.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Match any: a country name or ISO code (`Germany`, `DE`, `US`) or text inside the job's location (`Berlin`, `Remote`).", "items": { "type": "string" } }, "workplace": { "title": "Workplace", "type": "array", "description": "Only these work arrangements.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "seniority": { "title": "Seniority", "type": "array", "description": "Only these levels (derived from the title; jobs without a recognisable level never match when this is set).", "items": { "type": "string", "enum": [ "intern", "junior", "mid", "senior", "lead", "staff", "principal", "manager", "director", "executive" ], "enumTitles": [ "Intern", "Junior", "Mid-level", "Senior", "Lead", "Staff", "Principal", "Manager", "Director", "Executive" ] } }, "functions": { "title": "Job function", "type": "array", "description": "Only these job families (derived from the title or department).", "items": { "type": "string", "enum": [ "engineering", "data", "security", "it", "product", "design", "customer_success", "sales", "marketing", "finance", "people", "legal", "support", "healthcare", "education", "operations", "manufacturing_trades", "retail_hospitality", "driving_delivery", "admin", "research", "strategy_management" ] } }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Only these contract types.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "internship" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship" ] } }, "atsPlatforms": { "title": "Source platforms", "type": "array", "description": "Only jobs from these career-site platforms. Leave empty for all six.", "items": { "type": "string", "enum": [ "greenhouse", "lever", "ashby", "recruitee", "personio", "smartrecruiters" ], "enumTitles": [ "Greenhouse", "Lever", "Ashby", "Recruitee", "Personio", "SmartRecruiters" ] } }, "companies": { "title": "Companies", "type": "array", "description": "Only these companies. Use the company name or its career-site slug (`stripe`, `Notion`, `greenhouse:stripe`). Companies that are not in the index are reported in the log.", "items": { "type": "string" } }, "minSalaryUsd": { "title": "Minimum annual salary (USD)", "minimum": 0, "type": "integer", "description": "Only jobs that publish a salary range whose top end is at least this much per year. Non-USD and hourly/monthly pay is converted with approximate fixed rates (see `salaryApproxFx`)." }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "type": "integer", "description": "Jobs mode: only jobs posted in the last N days (0 = any age). Reading stops as soon as `Max items` is reached, so a narrow window is also the fastest.", "default": 30 }, "changesSince": { "title": "Changes since (date)", "type": "string", "description": "Changes mode: include the daily change files created on or after this date (`YYYY-MM-DD`). Empty = only the latest daily change file. Up to 7 days of history are kept." }, "changeTypes": { "title": "Change types", "type": "array", "description": "Changes mode: which events to return. Empty = all.", "items": { "type": "string", "enum": [ "new", "closed", "changed" ], "enumTitles": [ "New jobs", "Closed jobs", "Changed jobs" ] } }, "minOpenJobs": { "title": "Minimum open jobs", "minimum": 1, "type": "integer", "description": "Companies mode: only companies with at least this many open jobs.", "default": 1 }, "descriptionMode": { "title": "Job description", "enum": [ "none", "truncated", "full" ], "type": "string", "description": "**none**: no description. **truncated**: first N characters (billed as a normal job record). **full**: complete text, billed as an additional `Full job description` event for every job that has one. Descriptions are plain text with e-mails and phone numbers removed.", "default": "truncated" }, "descriptionMaxChars": { "title": "Truncated description length", "minimum": 100, "maximum": 20000, "type": "integer", "description": "Characters kept in `truncated` mode.", "default": 1500 }, "includeAiOptOut": { "title": "Include jobs that opted out of AI use", "type": "boolean", "description": "Some Greenhouse employers flag postings as opted out of AI processing. They are excluded by default; if included, their descriptions are still withheld.", "default": false }, "includeLowQuality": { "title": "Include low-quality boards", "type": "boolean", "description": "By default the feed leaves out boards that look like spam or mass-repeated postings (for example one title posted thousands of times, or one posting per store). Turn this on to include them; every record then carries `qualityFlags` explaining why.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum records to return (and pay for). Also respects the run's maximum charge.", "default": 100 } } }, "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 } } } } } } } } } }