{ "openapi": "3.0.1", "info": { "title": "Personio, Recruitee & Teamtailor Jobs API", "description": "Open jobs from company career sites on Personio, Recruitee and Teamtailor in one clean table: title, company, department, city, country, remote, contract, salary, skills and a link to the full ad. Filter by keyword, country, city and date, discover employers, or track new and removed jobs daily.", "version": "0.2", "x-build-id": "1ycwB9RQuvIdRhFkR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/belgair~european-ats-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-belgair-european-ats-jobs", "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/belgair~european-ats-jobs/runs": { "post": { "operationId": "runs-sync-belgair-european-ats-jobs", "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/belgair~european-ats-jobs/run-sync": { "post": { "operationId": "run-sync-belgair-european-ats-jobs", "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": { "companies": { "title": "Companies", "type": "array", "description": "One company per line: a careers URL (https://acme.jobs.personio.de, acme.recruitee.com, acme.teamtailor.com), a company slug (acme) or a domain (acme.com). A slug or domain is tried on all three systems. For a Teamtailor career site on its own domain, write teamtailor:careers.acme.com. With the default 10-minute timeout one run reads about 200 to 300 careers URLs, or about 70 to 100 slugs or domains (each is tried three times); companies not reached are listed as not checked. For longer lists, raise the run timeout or split the list. A line that cannot be read is skipped.", "items": { "type": "string" } }, "discover": { "title": "Discover companies", "type": "array", "description": "Also search the built-in list of employers with open jobs on these systems (most of them European; found through job posts on Hacker News, links on their own websites or by name, each checked against the job feed). Combine with filters, for example keyword Python and country Germany. The list does not contain every company on these systems.", "items": { "type": "string", "enum": [ "personio", "recruitee", "teamtailor" ], "enumTitles": [ "Personio", "Recruitee", "Teamtailor" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep jobs whose title, department or job text mentions at least one of these words or phrases (whole words: \"go\" does not match \"good\"). The job text is only searched, never returned. Empty = all jobs.", "items": { "type": "string" } }, "searchIn": { "title": "Search keywords in", "enum": [ "titleAndDescription", "title" ], "type": "string", "description": "Where the keywords must appear.", "default": "titleAndDescription" }, "countries": { "title": "Countries", "type": "array", "description": "Keep jobs in these countries: a name (Germany, Deutschland) or a code (DE). Personio feeds name only the office, so for Personio jobs the country is looked up once per office on the public job page; a job whose page gives no address is left out.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Keep jobs whose location contains one of these cities (Berlin, München, Amsterdam).", "items": { "type": "string" } }, "departments": { "title": "Departments", "type": "array", "description": "Keep jobs whose department contains one of these words (Engineering, Sales).", "items": { "type": "string" } }, "remote": { "title": "Remote", "enum": [ "any", "remote", "remoteOrHybrid", "hybrid", "onsite" ], "type": "string", "description": "Work model as the employer states it. Jobs without this information only appear with \"Any\".", "default": "any" }, "postedSince": { "title": "Posted since", "type": "string", "description": "Keep jobs published on or after this date, or within a period such as 14 days." }, "onlyNew": { "title": "Only new, changed or removed since the last run", "type": "boolean", "description": "Return only jobs that are new, changed (title, department, location, remote, contract, salary, skills or language) or removed since the previous run with the same companies and filters. The first run saves a baseline and returns nothing. Schedule it daily; you only pay for the changes.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many jobs (in tracking mode: changes).", "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 } } } } } } } } } }