# Personio Jobs & Careers Scraper (`scrapers_lat/personio-jobs-scraper`) Actor
Scrape Personio career page job listings by company. Extract job title, location, department, employment type, seniority, schedule, apply URL and full description. Filter by keyword. Export JSON, CSV or Excel. No login or API key.
- **URL**: https://apify.com/scrapers\_lat/personio-jobs-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
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
[](https://console.apify.com/actors/75my9Q3egarKP2jtu/input)
## Personio Jobs & Careers Scraper
> Extract every open role from any company hiring through Personio, straight from the public career page, with title, location, department, employment type, seniority and full description
22 fields per record
Any company on Personio
JSON / CSV / Excel output formats
Updated 2026-07-05
### What you get
Point the scraper at one or more Personio companies (the company subdomain like optiply or ottonova, the career page host, or the full career page URL) and get every open role as a structured record:
- **title**: the job title
- **company**: the hiring company name
- **location**: the primary office or work location for the role
- **offices**: every office attached to the role, including additional locations
- **department**: the department the role sits in
- **recruitingCategory**: the recruiting category the employer files the role under
- **occupation**: the occupation classification for the role
- **occupationCategory**: the broader occupation category
- **employmentType**: permanent, intern, working student and other contract types
- **seniority**: the seniority level of the role
- **schedule**: full-time, part-time or flexible schedule
- **yearsOfExperience**: the experience range the employer expects, when set
- **keywords**: skill and topic tags the employer attaches to the role
- **url**: the public apply URL for the job
- **jobId**: the Personio job posting ID
- **subcompany**: the specific legal entity or subcompany hiring, when set
- **company_subdomain**: the Personio company the job came from
- **createdAt**: when the posting first went live
- **sections\***: the structured description sections, each with its heading and content
- **descriptionHtml\***: the full job description as HTML
- **descriptionText\***: the full job description as clean plain text
- **observedAt**: when this listing was last seen by the scraper
*\*These fields only appear when Fetch full job description is set to true.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Track open roles at target companies for candidate outreach | Recruiters and staffing agencies |
| Read hiring signals to time sales and prospecting | Sales and revenue teams |
| Monitor competitor headcount and team growth | Market and competitive researchers |
| Build a live job board or careers aggregator feed | Job board and marketplace builders |
| Analyze roles, locations and seniority across Europe at scale | Talent and labor market analysts |
### Frequently Asked Questions
**Which companies can I scrape with this?**
Any company that publishes its career page through Personio, which is widely used across Germany, Austria, Switzerland, the Netherlands, Spain and the rest of Europe. Enter the company subdomain, the career page host or the full career page URL, one entry per company.
**How do I find a company's Personio identifier?**
It is the company slug in its Personio career page address. If a company hires through optiply.jobs.personio.com, the identifier is optiply. You can paste the slug, the host or the full URL and the scraper will normalize it.
**How many jobs can it return per company?**
It returns every open role on the career page, which ranges from a handful to several hundred per company. Use Max Items to cap the total across all companies when you only need a sample.
**Can I filter to specific roles?**
Yes. Use the Keyword filter to keep only jobs whose title, department, location, category or description contain your keyword, for example engineer, remote or sales. Leave it empty to return every open role.
**What happens if a company cannot be reached?**
If a company slug does not exist or its career page is not publicly accessible, the scraper records an error row for that company and moves on to the next one, so a single bad entry never stops the run.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [Greenhouse Job Board Listings Scraper](https://apify.com/scrapers_lat/greenhouse-jobs-scraper): Every open role from any company hiring on Greenhouse ATS.
- [Seek Australia Jobs & Salary Scraper](https://apify.com/scrapers_lat/seek-jobs-scraper): Job listings and salary data from Seek Australia and New Zealand.
- [Jora Jobs & Salary Scraper](https://apify.com/scrapers_lat/jora-jobs-scraper): Job postings and pay ranges across Jora in Australia, NZ and Asia.
- [GetOnBrd LATAM Tech Jobs Scraper](https://apify.com/scrapers_lat/getonbrd-scraper): Latin American tech job listings with salary data.
- [LinkedIn Jobs & Company Scraper](https://apify.com/scrapers_lat/linkedin-jobs-scraper): Job postings with company, seniority and location fields.
- [Crunchbase Company & Funding Scraper](https://apify.com/scrapers_lat/crunchbase-scraper): Company profiles, funding rounds and investor data.
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with Personio. It only accesses data that is publicly available on company career pages. Use it in accordance with Personio's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of job listings to collect across all companies. Optional.
## `withDetails` (type: `boolean`):
When enabled, each job includes the full description as HTML and clean text plus the structured description sections. When disabled, only the lightweight listing fields (title, location, department, employment type, seniority, schedule, apply URL, dates) are collected.
## `companies` (type: `array`):
The Personio companies to scrape. Enter the company subdomain (for example optiply or ottonova), the career page host (optiply.jobs.personio.com) or the full career page URL. Add one entry per company.
## `searchQuery` (type: `string`):
Optional keyword to filter jobs after they are fetched. Matches against the job title, department, location, category and description (case-insensitive). Leave empty to return every open job.
## `proxyConfiguration` (type: `object`):
Proxy settings. Personio career pages are public, so a proxy is optional and datacenter IPs work fine. Enable a proxy only if you hit IP rate limits.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"companies": [
"ottonova",
"optiply",
"everphone",
"clark"
],
"proxyConfiguration": {
"useApifyProxy": false
}
}
````
# 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 = {
"maxItems": 10,
"companies": [
"ottonova",
"optiply",
"everphone",
"clark"
],
"searchQuery": ""
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/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 = {
"maxItems": 10,
"companies": [
"ottonova",
"optiply",
"everphone",
"clark",
],
"searchQuery": "",
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/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 '{
"maxItems": 10,
"companies": [
"ottonova",
"optiply",
"everphone",
"clark"
],
"searchQuery": ""
}' |
apify call scrapers_lat/personio-jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/personio-jobs-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Personio Jobs & Careers Scraper",
"description": "Scrape Personio career page job listings by company. Extract job title, location, department, employment type, seniority, schedule, apply URL and full description. Filter by keyword. Export JSON, CSV or Excel. No login or API key.",
"version": "0.1",
"x-build-id": "JYMMwg80CI52rLWHX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~personio-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~personio-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-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/scrapers_lat~personio-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-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": [
"companies"
],
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of job listings to collect across all companies. Optional."
},
"withDetails": {
"title": "Fetch full job description",
"type": "boolean",
"description": "When enabled, each job includes the full description as HTML and clean text plus the structured description sections. When disabled, only the lightweight listing fields (title, location, department, employment type, seniority, schedule, apply URL, dates) are collected.",
"default": true
},
"companies": {
"title": "Companies",
"type": "array",
"description": "The Personio companies to scrape. Enter the company subdomain (for example optiply or ottonova), the career page host (optiply.jobs.personio.com) or the full career page URL. Add one entry per company.",
"items": {
"type": "string"
}
},
"searchQuery": {
"title": "Keyword filter",
"type": "string",
"description": "Optional keyword to filter jobs after they are fetched. Matches against the job title, department, location, category and description (case-insensitive). Leave empty to return every open job."
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings. Personio career pages are public, so a proxy is optional and datacenter IPs work fine. Enable a proxy only if you hit IP rate limits.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```