# Personio Job Board Scraper — All Company Jobs (`hipersoft/personio-scraper`) Actor

Scrape all open jobs from any company's Personio careers page: title, office, department, employment type, seniority, schedule, experience and description. Bulk companies. Public XML feed, no setup.

- **URL**: https://apify.com/hipersoft/personio-scraper.md
- **Developed by:** [Hipersoft](https://apify.com/hipersoft) (community)
- **Categories:** Jobs
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0005 / job scraped

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Personio Job Scraper — Jobs, Offices, Departments & Descriptions

Scrape **every open job** from any company that hosts its careers page on **Personio**. Extract **job title, office, department, employment type, seniority, schedule, years of experience, created date, full description and apply link** into clean JSON, CSV, Excel or XML. Popular across the **DACH region and Europe**. Pass one company or many in a single run. Fast and reliable.

![Personio Job Scraper input — companies, full description and job cap in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/personio-scraper-input.png?v=2)

### What does Personio Job Scraper do?

Personio Job Scraper collects the full list of open roles from any Personio-hosted careers page and returns them as structured data. Point it at one or many companies and export the jobs, offices, departments, seniority levels and descriptions you need for aggregation, sourcing or hiring-trend analysis.

### What data can you scrape from Personio?

- 🏢 **Company** — the Personio subdomain each job belongs to
- 📋 **Job details** — title, department, recruiting category, occupation
- 📍 **Offices** — primary office plus all offices the role is open in
- 💼 **Role type** — employment type, seniority, schedule
- 🎓 **Experience** — years of experience required
- 📝 **Full descriptions** — combined job-description sections (optional)
- 🔗 **Apply link** — direct URL to apply
- 🗓️ **Created date** — when the role was posted

### Use cases

- **Job aggregators & boards** — feed fresh, structured Personio listings into your own site
- **Recruiting & sourcing** — monitor which companies are hiring across the DACH region and Europe
- **Hiring-trend analysis** — track departments, offices, seniority and schedules over time
- **ATS & CRM enrichment** — keep an internal dataset of open roles up to date
- **Lead generation** — find companies actively hiring for particular skills

### How to scrape Personio job data

1. Add Personio Job Scraper to your Apify account.
2. Enter one or more companies in `companies` — a Personio subdomain (e.g. `personio`) or a full career URL.
3. Toggle `includeContent` to add each job's full description.
4. Set `maxJobsPerCompany` to cap results per company (0 = all).
5. Run the Actor and export the results as JSON, CSV, Excel or XML — or pull them via the API.

### Input

```json
{
  "companies": ["personio", "https://tado.jobs.personio.com"],
  "includeContent": true,
  "maxJobsPerCompany": 0
}
```

| Field | Description |
|-------|-------------|
| `companies` | Personio subdomains or career URLs (e.g. `personio` or `https://tado.jobs.personio.com`) — **required**. |
| `includeContent` | Include each job's full description. Default `true`. |
| `maxJobsPerCompany` | Maximum jobs to return per company. `0` = all. |
| `proxyConfiguration` | Proxy configuration for the run — leave the default. |

### Output

![Personio Job Scraper output example — job listings as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/personio-scraper-output.png?v=5)

```json
{
  "company": "personio",
  "jobId": 1834171,
  "title": "Staff Software Engineer, Data Platform",
  "office": "Munich",
  "offices": ["Munich", "Vienna"],
  "department": "Product and Tech",
  "recruitingCategory": "Engineering",
  "employmentType": "permanent",
  "seniority": "experienced",
  "schedule": "full-time",
  "yearsOfExperience": "7-10",
  "occupation": "Software Engineer",
  "occupationCategory": "IT & Software Development",
  "createdAt": "2026-07-10T09:14:00Z",
  "applyUrl": "https://personio.jobs.personio.com/job/1834171",
  "description": "Your responsibilities… (when includeContent is on)"
}
```

#### Output schema

| Field | Type | Description |
|-------|------|-------------|
| `company` | string | Personio subdomain the job belongs to. |
| `jobId` | integer | Unique Personio job listing ID. |
| `title` | string | Job title. |
| `office` | string | Primary office for the role. |
| `offices` | array | All offices the role is open in. |
| `department` | string | Department the role sits in. |
| `recruitingCategory` | string | Recruiting category for the role. |
| `employmentType` | string | Employment type, e.g. permanent, temporary. |
| `seniority` | string | Seniority level, e.g. experienced, entry-level. |
| `schedule` | string | Work schedule, e.g. full-time, part-time. |
| `yearsOfExperience` | string | Years of experience required. |
| `occupation` | string | Occupation for the role. |
| `occupationCategory` | string | Broader occupation category. |
| `createdAt` | string (ISO date) | When the role was created. |
| `applyUrl` | string (URL) | URL to apply for the role. |
| `description` | string | Full job description text (when `includeContent` is on). |

### Need more job data?

Combine Personio with other job sources for wider coverage:

- [SmartRecruiters Job Scraper](https://apify.com/hipersoft/smartrecruiters-scraper) — jobs from SmartRecruiters career sites.
- [Ashby Job Board Scraper](https://apify.com/hipersoft/ashby-scraper) — jobs from Ashby careers boards.
- [Greenhouse Job Board Scraper](https://apify.com/hipersoft/greenhouse-scraper) — jobs from Greenhouse careers boards.
- [Arbeitnow Job Scraper](https://apify.com/hipersoft/arbeitnow-scraper) — jobs across Europe with tags and descriptions.

### FAQ

**Where do I find a company's Personio subdomain?**
It's in the careers URL — `personio.jobs.personio.com` → `personio`. A full URL works too.

**How many jobs can I scrape per run?**
Use `maxJobsPerCompany` to cap results per company, or set `0` for all. Add more companies to `companies` for wider coverage.

**How does billing work?**
You pay per job you get, plus a small per-request charge — pay only for what you scrape.

**What's the output format?**
Structured JSON — one record per job with title, office, department, employment type, seniority, schedule, dates, links and (optionally) the full description. Export as JSON, CSV, Excel or XML.

**Is scraping Personio job boards legal?**
Only public job data shown to any visitor on a Personio careers page is collected. This is an independent tool, not affiliated with Personio; check Personio's and each company's terms and applicable regulations for your use case.

**Can I integrate this with other tools?**
The Personio Job Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

### Related Actors

- [Himalayas Remote Jobs Scraper](https://apify.com/hipersoft/himalayas-scraper) — remote roles with salaries worldwide.
- [Lever Job Board Scraper](https://apify.com/hipersoft/lever-scraper) — jobs from Lever careers boards.
- [Dice Jobs Scraper](https://apify.com/hipersoft/dice-scraper) — US tech jobs with salaries.
- [RemoteOK Job Scraper](https://apify.com/hipersoft/remoteok-scraper) — remote roles with tags and salary ranges.

### Notes

Original clean-room implementation. Returns only public data; you are responsible for compliance with Personio's and each company's terms. Not affiliated with Personio.

# Actor input Schema

## `companies` (type: `array`):

Personio company subdomains or career URLs — e.g. "personio" or https://personio.jobs.personio.com.

## `includeContent` (type: `boolean`):

Include each job's full description text.

## `maxJobsPerCompany` (type: `integer`):

Limit jobs per company. 0 = all.

## `proxyConfiguration` (type: `object`):

Proxy configuration. Leave the default — it is tuned for reliable results.

## Actor input object example

```json
{
  "companies": [
    "personio",
    "tado"
  ],
  "includeContent": true,
  "maxJobsPerCompany": 0,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companies": [
        "personio",
        "tado"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/personio-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "companies": [
        "personio",
        "tado",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/personio-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companies": [
    "personio",
    "tado"
  ]
}' |
apify call hipersoft/personio-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/personio-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yJRVQw69ItQJ5D4Af/builds/k2CGnMkKhG2ady9x1/openapi.json