{ "openapi": "3.0.1", "info": { "title": "Employer-Direct Jobs API - 2M+ Live Listings (JOA)", "description": "Search live and closed job listings taken straight from employer ATS, career sites and public agencies. Every field tagged published or inferred, with freshness timestamps. No scraping, no proxies - pay per record.", "version": "0.0", "x-build-id": "WNLqtTkPYCPmPrTCL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/job_opportunities_api~job-opportunities-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-job_opportunities_api-job-opportunities-api", "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/job_opportunities_api~job-opportunities-api/runs": { "post": { "operationId": "runs-sync-job_opportunities_api-job-opportunities-api", "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/job_opportunities_api~job-opportunities-api/run-sync": { "post": { "operationId": "run-sync-job_opportunities_api-job-opportunities-api", "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", "closed_jobs", "companies" ], "type": "string", "description": "What to fetch. Jobs = live vacancies. Closed jobs = roles that left their source (hiring signal). Companies = employers with open roles.", "default": "jobs" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on records returned (and billed). The run stops as soon as it is reached. Use Start cursor to continue a large pull in a later run.", "default": 100 }, "query": { "title": "Search text", "type": "string", "description": "Full-text over job title, company name and location (Jobs / Closed jobs), or over the company name (Companies). Example: data engineer berlin" }, "titleQuery": { "title": "Title contains", "type": "string", "description": "Full-text over the job title only. ANDs with everything else. Jobs / Closed jobs only." }, "titleExclude": { "title": "Title excludes", "type": "string", "description": "Drop rows whose title matches these words, e.g. intern trainee. Jobs / Closed jobs only." }, "descriptionContains": { "title": "Description contains", "type": "string", "description": "Full-text over the advert body (only rows that carry a description). Example: kubernetes terraform. Jobs / Closed jobs only." }, "countries": { "title": "Countries", "type": "array", "description": "ISO-3166 alpha-2 codes, e.g. DE, GR, FR, NL. Empty = worldwide.", "items": { "type": "string" } }, "excludeCountries": { "title": "Exclude countries", "type": "array", "description": "ISO-3166 alpha-2 codes to remove.", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "City name as it appears in the ledger, e.g. Berlin. Jobs / Closed jobs only." }, "remote": { "title": "Work model", "type": "array", "description": "Remote / hybrid / on-site. Note: for most rows the work model is INFERRED — tick 'Only source-confirmed remote status' to keep rows where the employer stated it.", "items": { "type": "string", "enum": [ "remote", "hybrid", "on_site", "not_stated" ], "enumTitles": [ "Remote", "Hybrid", "On site", "Not stated" ] } }, "remoteConfirmed": { "title": "Only source-confirmed remote status", "type": "boolean", "description": "Keep only rows whose remote status was published by the employer (not inferred by us).", "default": false }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Full-time, Part-time, Contract, Temporary, Internship, or not_stated.", "items": { "type": "string", "enum": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "not_stated" ] } }, "seniorities": { "title": "Seniority", "type": "array", "description": "Entry, Intern, Mid, Senior, Lead, Manager, Director, Executive, or not_stated. Seniority is inferred and only stated where confidence is high.", "items": { "type": "string", "enum": [ "Intern", "Entry", "Mid", "Senior", "Lead", "Manager", "Director", "Executive", "not_stated" ] } }, "categories": { "title": "Job category", "type": "array", "description": "Job family. 'uncategorised' selects rows without a confident classification.", "items": { "type": "string", "enum": [ "Healthcare", "Engineering", "Operations & Admin", "Sales", "uncategorised", "Skilled Technician", "Hospitality", "Retail", "Finance", "Logistics & Transport", "Marketing", "Customer Support", "Education", "Manufacturing", "HR & Recruiting", "Data & Analytics", "Consulting & Strategy", "Construction & Trades", "Legal & Compliance", "Design", "Product", "Science & Research", "Security", "Procurement", "Safety & Environment" ] } }, "sourceTypes": { "title": "Source type", "type": "array", "description": "Where the row comes from: Employer ATS, company career site, or public employment agency.", "items": { "type": "string", "enum": [ "ats", "career_site", "public_agency" ], "enumTitles": [ "Employer ATS", "Company career site", "Public employment agency" ] } }, "companySlugs": { "title": "Company slugs", "type": "array", "description": "Restrict to specific employers by JOA slug (find slugs in Companies mode), e.g. e-vita-gmbh.", "items": { "type": "string" } }, "companyDomains": { "title": "Company domains", "type": "array", "description": "Restrict to employers by bare domain (no scheme, no path), e.g. stripe.com, figma.com.", "items": { "type": "string" } }, "hasSalary": { "title": "Only rows with a published salary", "type": "boolean", "description": "Keep only rows whose salary was published by the employer. Roughly 2% of the ledger carries structured salary — combine with a country to keep results useful.", "default": false }, "minSalaryEurAnnual": { "title": "Minimum annual salary (EUR)", "minimum": 0, "type": "integer", "description": "Lower bound on the normalised annual salary in EUR. Implies published salary." }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only roles posted in the last N days. Jobs / Closed jobs only." }, "verifiedWithinDays": { "title": "Re-verified within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only roles re-confirmed at their source in the last N days — the freshness filter. 97% of the ledger is re-checked inside 48 hours, so 2 is a good value. Jobs / Closed jobs only." }, "closedWithinDays": { "title": "Closed within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Closed jobs mode: only roles that closed in the last N days." }, "closedReason": { "title": "Closed reason", "enum": [ "", "expired_upstream", "not_seen", "employer_closed", "deadline_passed" ], "type": "string", "description": "Closed jobs mode: why the role left the ledger.", "default": "" }, "includeDescription": { "title": "Include full advert text", "type": "boolean", "description": "Add the full job description (about 2.5 KB per row) in a description field. Same price per record.", "default": false }, "companyOrgType": { "title": "Employer type", "type": "string", "description": "Companies mode only: organisation type filter, e.g. BPO, Staffing, Enterprise (see the values in Companies-mode output)." }, "companyHasWebsite": { "title": "Only employers with a verified website", "type": "boolean", "description": "Companies mode only.", "default": false }, "startCursor": { "title": "Start cursor", "type": "string", "description": "Resume a previous pull: paste the next_cursor from that run's SUMMARY record. Keep every other input identical." } } }, "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 } } } } } } } } } }