{ "openapi": "3.0.1", "info": { "title": "Personio Jobs Scraper: Career Pages in Germany & DACH", "description": "Get all open jobs from Personio career pages (*.jobs.personio.de) live: salary, remote type, department, country and full description in one clean format. Ideal for the German Mittelstand. Track new and closed jobs. No proxies, pay per job.", "version": "0.1", "x-build-id": "Z7u3Znb9p5dleqm2z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/veedel_digital~personio-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-veedel_digital-personio-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/veedel_digital~personio-jobs/runs": { "post": { "operationId": "runs-sync-veedel_digital-personio-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/veedel_digital~personio-jobs/run-sync": { "post": { "operationId": "run-sync-veedel_digital-personio-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", "required": [ "companies" ], "properties": { "companies": { "title": "Personio companies", "type": "array", "description": "One per line: the Personio company name (the part before .jobs.personio.de, e.g. \"1komma5grad\"), a Personio career page URL (https://tado.jobs.personio.com) or the URL of a single Personio job.", "items": { "type": "string" } }, "titleKeywords": { "title": "Job title contains (any of)", "type": "array", "description": "Keep jobs whose title contains at least one of these words, e.g. \"data\", \"sales\", \"werkstudent\". Whole words: \"java\" does not match \"JavaScript\". Add * for word starts: \"engineer*\" also matches \"Engineering\". Empty = all jobs.", "items": { "type": "string" } }, "excludeTitleKeywords": { "title": "Job title must not contain", "type": "array", "description": "Drop jobs whose title contains any of these words, e.g. \"intern\", \"praktikum\".", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Keep jobs in any of these places. Use a country code (DE, US), a country (Germany) or a city (Berlin). Empty = worldwide.", "items": { "type": "string" } }, "workplace": { "title": "Workplace type", "type": "array", "description": "Keep only remote, hybrid or on-site jobs. Jobs where the ATS gives no workplace type are dropped when this filter is set.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "departments": { "title": "Department contains", "type": "array", "description": "Keep jobs whose department or team contains one of these words, e.g. \"engineering\", \"sales\".", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "type": "integer", "description": "Keep jobs published in the last N days. 0 = any date. Jobs without a publish date are dropped when this is set.", "default": 0 }, "onlyWithSalary": { "title": "Only jobs with salary", "type": "boolean", "description": "Keep only jobs with a salary range (from the ATS or found in the job description).", "default": false }, "onlyNewSinceLastRun": { "title": "Only new jobs since the last run", "type": "boolean", "description": "Remembers which jobs it has seen for this company list and these filters. The first run returns all jobs, every later run only new ones, so you pay only for new jobs. Perfect for a daily schedule.", "default": false }, "reportClosedJobs": { "title": "Report closed jobs", "type": "boolean", "description": "With \"Only new jobs\" enabled: also add a free row for every job that disappeared since the last run (recordType \"closed-job\").", "default": true }, "stateKey": { "title": "Monitoring name (optional)", "type": "string", "description": "Name for the saved state, e.g. \"sales-leads-dach\". Leave empty to derive it from the company list and filters. Use the same name in several tasks to share one state." }, "includeDescription": { "title": "Include job description", "type": "boolean", "description": "Full job description as plain text. Turn off for smaller, faster results.", "default": true }, "mergeDuplicates": { "title": "Merge the same job posted in several cities", "type": "boolean", "description": "Many companies post one role once per city. Merge them into one row with all locations (duplicateIds lists the merged job IDs).", "default": false }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "Stop after this many matching jobs per company. 0 = no limit.", "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 } } } } } } } } } }