# Personio Jobs Scraper - Company Career Sites (`benthepythondev/personio-jobs-scraper`) Actor Scrape jobs from public Personio company career sites. Export title, company, office, department, employment type, seniority, schedule, description and apply URL. - **URL**: https://apify.com/benthepythondev/personio-jobs-scraper.md - **Developed by:** [Ben](https://apify.com/benthepythondev) (community) - **Categories:** Jobs, Business, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Personio Jobs Scraper - Company Career Sites Scrape public job openings from company career sites hosted on Personio. Paste one or more `jobs.personio.de` or `jobs.personio.com` URLs and receive structured job records with the title, company, office, department, employment type, seniority, schedule, experience range, complete public description sections, job URL, and direct application link. The Actor is built for recruitment research, job aggregation, competitive hiring intelligence, lead generation, and recurring career-site monitoring. It uses Personio's public XML feed when available and falls back to server-rendered career cards on newer site versions. No Personio account, employer credentials, or private applicant data is required. ### Why Personio career data matters Thousands of European companies use Personio to publish vacancies. The public career sites are individually searchable, but tracking many employers manually is slow and inconsistent. A structured company-by-company feed makes it possible to monitor hiring demand, identify relevant vacancies, follow department growth, and power niche job products without maintaining a separate parser for every employer website. Common workflows include: - monitoring target companies for new openings; - building a regional or industry-specific job board; - tracking hiring activity by department and location; - collecting direct apply links for candidate alerts; - creating sales signals from company expansion; - comparing job titles, seniority, and office distribution; - feeding job records into Make, Zapier, n8n, Sheets, or a database; - archiving public descriptions for longitudinal labor-market analysis. ### Input Provide the public base URL for each Personio career site. The Actor accepts both the legacy `.de` and current `.com` domains. ```json { "careerSiteUrls": [ "https://personio.jobs.personio.de", "https://ijgd-1.jobs.personio.de" ], "language": "en", "includeDescriptions": true, "maxResultsPerSite": 50 } ```` #### Input fields | Field | Description | |---|---| | `careerSiteUrls` | One or more public Personio company career-site URLs. | | `language` | Feed language such as `en`, `de`, `fr`, or `es`. | | `includeDescriptions` | Include the complete public description sections when the XML feed provides them. | | `maxResultsPerSite` | Maximum records saved from each company site. | The default points to Personio's own public career site and uses a bounded result limit. Invalid domains and oversized inputs are rejected before crawling. ### Output Each default-dataset item represents one unique job at one company. Fields can include: - stable public Personio job ID; - title, company, and company-site slug; - primary office and additional offices; - department and recruiting category; - employment type, seniority, and schedule; - expected years of experience; - occupation and occupation category; - source creation timestamp; - normalized full description and section headings; - public job URL and direct `#apply` URL; - source mode (`personio_xml` or `personio_html`), career-site URL, and scrape timestamp. Example output: ```json { "id": "1834171", "title": "Staff Software Engineer, Data Platform", "company": "Personio SE & Co. KG", "office": "Munich", "additional_offices": ["Berlin"], "department": "Product and Tech", "employment_type": "permanent", "seniority": "experienced", "schedule": "full-time", "url": "https://personio.jobs.personio.de/job/1834171?language=en", "apply_url": "https://personio.jobs.personio.de/job/1834171#apply" } ``` ### XML and HTML modes Personio has more than one public career-site generation. Legacy-compatible sites expose a structured XML feed containing rich metadata and description sections. The Actor requests that feed first because it is fast and precise. If the feed is absent or contains no positions, the Actor fetches the public career homepage and extracts available job cards instead. The `source` field tells downstream workflows which path produced the row. XML records generally contain more fields. HTML fallback records preserve the public job identity, title, card text, and URLs rather than failing the entire company run. ### Monitoring workflow For repeat monitoring: 1. save your company list as an Apify Task; 2. schedule it daily or weekly; 3. retain the job ID plus company slug as a stable key; 4. compare the latest run with the previous dataset; 5. notify a recruiter, candidate, analyst, or sales team only when a new key appears. This produces a focused signal instead of repeatedly sending the full open-job list. Webhooks can forward completed runs to your existing automation system. ### Lead and market intelligence Hiring activity is a useful business signal. New engineering, sales, finance, or operations roles can indicate expansion, a new market, or a product investment. Combine Personio output with lawful company enrichment to prioritize research. A public job post is not consent to unrelated outreach, so follow applicable privacy, marketing, and platform rules. ### Pricing This Actor uses transparent pay-per-event pricing: one small start event and one result event for each unique job stored in the default dataset. Its `$0.005` start and `$0.001` result price is designed for recurring multi-company monitoring. Duplicate company/job IDs within one run are removed before storage. ### Reliability and scope The Actor uses public Personio career surfaces through lightweight HTTP requests with retries and strict company/result limits. It does not access employer dashboards, candidate records, application submissions, or login-only data. The default input is expected to finish quickly with non-empty output, which supports Apify's automated reliability checks. Career-site owners can close or move vacancies at any time. The dataset is a run-time observation, not a guarantee that an opening is still available. Verify the final vacancy and application requirements on the linked company page. ### FAQ #### Do I need a Personio API key? No. This Actor reads public career-site data, not the private employer API. #### Can I scrape multiple companies? Yes. Add each public Personio career-site base URL to the input list. #### Does it include full job descriptions? Yes when the public XML feed exposes them and `includeDescriptions` is enabled. Newer HTML-only sites may provide fewer fields. #### Can I choose German or another language? Yes. Set the language code. Availability depends on the employer's published translations. #### Does it collect applicant data? No. It only reads public job postings and never opens private HR records. #### Can I export CSV or Excel? Yes. Open the dataset and choose JSON, CSV, Excel, XML, RSS, or the API endpoint. #### Why did one company return no jobs? The company may have no current openings, may use a different career-site host, or may have migrated away from Personio. Verify the base URL in a browser. #### How do I report an issue? Open an issue on the Actor page with the career-site URL and run ID. If the Actor saved you time, please leave a Store review; reviews help users compare tools and help prioritize maintenance. ### You might also like - [ATS Job Scrapers](https://apify.com/store?search=ATS%20jobs) - [Company Career Site Scrapers](https://apify.com/store?search=career%20site%20scraper) - [Recruitment Data Actors](https://apify.com/store?search=recruitment%20data) **Keywords:** Personio scraper, Personio jobs API, Personio career site scraper, ATS jobs scraper, company jobs monitor, Europe jobs data, recruiting intelligence, job board API, hiring signals, Personio XML feed # Actor input Schema ## `careerSiteUrls` (type: `array`): Public company career-site URLs on jobs.personio.de or jobs.personio.com. ## `language` (type: `string`): Personio feed language, for example en, de, fr, or es. ## `includeDescriptions` (type: `boolean`): Include the public description sections when the Personio XML feed exposes them. ## `maxResultsPerSite` (type: `integer`): Maximum public jobs saved from each company career site. ## Actor input object example ```json { "careerSiteUrls": [ "https://personio.jobs.personio.de", "https://ijgd-1.jobs.personio.de" ], "language": "en", "includeDescriptions": true, "maxResultsPerSite": 20 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "careerSiteUrls": [ "https://personio.jobs.personio.de", "https://ijgd-1.jobs.personio.de" ], "language": "en", "includeDescriptions": true, "maxResultsPerSite": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("benthepythondev/personio-jobs-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "careerSiteUrls": [ "https://personio.jobs.personio.de", "https://ijgd-1.jobs.personio.de", ], "language": "en", "includeDescriptions": True, "maxResultsPerSite": 20, } # Run the Actor and wait for it to finish run = client.actor("benthepythondev/personio-jobs-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "careerSiteUrls": [ "https://personio.jobs.personio.de", "https://ijgd-1.jobs.personio.de" ], "language": "en", "includeDescriptions": true, "maxResultsPerSite": 20 }' | apify call benthepythondev/personio-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=benthepythondev/personio-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Personio Jobs Scraper - Company Career Sites", "description": "Scrape jobs from public Personio company career sites. Export title, company, office, department, employment type, seniority, schedule, description and apply URL.", "version": "1.0", "x-build-id": "jRnA2JyLNmqJKZxkd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~personio-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-personio-jobs-scraper", "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/benthepythondev~personio-jobs-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-personio-jobs-scraper", "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/benthepythondev~personio-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-personio-jobs-scraper", "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": [ "careerSiteUrls" ], "properties": { "careerSiteUrls": { "title": "Personio career sites", "type": "array", "description": "Public company career-site URLs on jobs.personio.de or jobs.personio.com.", "default": [ "https://personio.jobs.personio.de" ], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Personio feed language, for example en, de, fr, or es.", "default": "en" }, "includeDescriptions": { "title": "Include full descriptions", "type": "boolean", "description": "Include the public description sections when the Personio XML feed exposes them.", "default": true }, "maxResultsPerSite": { "title": "Maximum jobs per site", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum public jobs saved from each company career site.", "default": 50 } } }, "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 } } }, "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 } } } } } } } } } } ```