Personio Job Board Scraper — DACH SME Hiring Signals 🚀

foXLabs hiring series: Greenhouse · Lever · Ashby · Workday · SmartRecruiters · Teamtailor

🎉 Turn any company's Personio board into clean, structured hiring data — no login, no API key, one row per open role. Built for recruiters, sales & competitive-intelligence teams, and anyone scoring hiring intent at scale.

🔍 What is the Personio Job Board Scraper — and when should you use it?

Personio is the HR system of the German-speaking Mittelstand. Give this actor a company slug (deskbird) or careers URL and it returns every open role with rich structured classification — department, seniority, schedule, occupation, office and posted date. The clearest public window into SME hiring across Germany, Austria and Switzerland.

Use it when you need: every open role at a target company, hiring-intent signals (which functions a company is growing), a recruiter sourcing list across many companies, or a clean read of a competitor's headcount plans — from the XML job feed every Personio careers site publishes at /xml, no key.

Use something else when: the company doesn't run on Personio. Point the matching actor at its ATS instead — every actor in the foXLabs hiring series emits the same schema, so their outputs concatenate into one hiring-intent table: Greenhouse · Lever · Ashby · Workday · SmartRecruiters · Teamtailor.

🤖 Use with AI agents

Already on the Apify MCP server? Ask for this Actor by name: foxlabs/personio-job-board-scraper.

Your agent can pay for its own runs. This Actor is pay-per-event with agentic payments, so an agent can discover it, run it and settle the bill over x402 (USDC on Base) or Skyfire — no Apify account or API token of its own. Billing is per delivered role, never for errors.

Otherwise paste this into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

I want to pull a company's open roles using the Apify Actor `foxlabs/personio-job-board-scraper`.
Input: `queries` is a list of a Personio company slug (`deskbird`) or careers URL. `maxResultsPerQuery` caps rows per company (default 200).
Start with: {"queries":["deskbird"],"maxResultsPerQuery":50}
Ask me which companies to track, run the Actor, then summarise the roles as a table.

The machine-readable API, MCP config and OpenAPI definition live at apify.com/foxlabs/personio-job-board-scraper.md.

📋 Overview

Everything you need to turn a Personio careers board into clean, structured data — role details, metadata and hiring signals — in one actor, with no login, cookies or API key.

Why teams pick this actor:

• ✅ Whole board in one call — every open role, no per-tool stitching.
• ⚡ Slug- or URL-native — paste what you already have; the actor resolves the rest.
• 🔗 Same schema across the series — join with the six sibling ATS actors on companyBoard.
• 💰 Pay only for results — per-row pricing, empty/failed lookups never billed.
• 🤖 Agent-ready — MCP + x402 agentic payments.
• 🇩🇪 DACH SME coverage — the mid-market segment US-centric ATS feeds miss entirely.
• ℹ️ Structured, not free-text — Personio's public feed publishes classification (department, seniority, schedule, occupation), not the description body.

🎬 Quick Start

curl -X POST "https://api.apify.com/v2/acts/foxlabs~personio-job-board-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["deskbird"],"maxResultsPerQuery":50}'

🚀 Getting Started (3 steps)

1. Choose your companies — a Personio company slug (deskbird) or careers URL.
2. Set the cap — maxResultsPerQuery limits rows per company (default 200).
3. Run and export — a clean dataset as JSON, CSV or Excel.

📥 Input

{
  "queries": [
    "personio",
    "deskbird",
    "https://deskbird.jobs.personio.com"
  ],
  "maxResultsPerQuery": 200,
  "maxConcurrency": 5,
  "includeRaw": false
}

Field	Type	Description
queries	array	a Personio company slug (deskbird) or careers URL.
maxResultsPerQuery	integer	Caps rows per company (default 200).
maxConcurrency	integer	How many companies to fetch at once.
includeRaw	boolean	Attach the source's untouched record under raw.
requestDelayMs	integer	Politeness delay between requests.
proxyConfiguration	object	Optional.

📤 Output

One row per open role, saved to the dataset.

Field	Type	Description
companyName	Company slug, title-cased
companyBoard	Personio slug — join key
jobId	Position ID
jobTitle	Role title
department	Department
recruitingCategory	Personio recruiting category
location	Office
isRemote	Remote flag
employmentType	Employment type
seniority	Seniority level
schedule	Full-time / part-time
yearsOfExperience	Experience band where published
occupationCategory	Occupation category
subcompany	Sub-company where set
postedAt	Posted date (ISO, from the feed)
applyUrl	Apply link
sourceUrl	Public posting URL

Every row also carries query, scrapedAt, and — when a lookup fails — an error.

💼 Use cases

1. DACH SME prospecting Input: target slugs. Output: roles by department + seniority. Use: find mid-market hiring data unavailable elsewhere.

2. Hiring-intent scoring Input: a set of Mittelstand slugs. Output: roles by occupation + schedule. Use: a company opening its first data roles is starting a data project.

3. Recruiter sourcing Input: many slugs. Output: roles + apply links. Use: source across DACH employers.

🔗 Integration

JavaScript / Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('foxlabs/personio-job-board-scraper').call({ queries: ['deskbird'], maxResultsPerQuery: 50 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')
run = client.actor('foxlabs/personio-job-board-scraper').call(run_input={'queries': ['deskbird'], 'maxResultsPerQuery': 50})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

Automation (n8n / Zapier / Make): schedule or webhook → HTTP request to the actor API → handle the JSON dataset → push to a sheet, CRM or dashboard.

📊 Pricing

Pay-per-event: $0.002 per delivered role. Empty or failed lookups are never billed. View current pricing.

❓ FAQ

Do I need an account, login or API key? No. This reads the XML job feed every Personio careers site publishes at /xml — no key.

What do I search by? A Personio company slug (deskbird) or careers URL.

How current is the data? Every run queries the source live, so results are as fresh as the board itself.

Can I export to CSV / Excel / JSON? Yes — directly from the Apify dataset.

What happens on a bad input or empty board? You get a row with your query and an error — nothing is silently dropped, and you're not charged.

Is scraping this legal? It reads a public job feed the company publishes for syndication — job data, not personal data. See below.

🐛 Troubleshooting

• "No Personio job feed found …" — pass a bare slug (the actor tries both .de and .com) or the exact careers URL.
• Personio rate-limited this IP — lower maxConcurrency, raise the delay, or turn the proxy on.
• No description field — Personio's public feed does not expose the description body; this actor returns the structured classification instead.

⚠️ Trademark

Independent, third-party tool. Not affiliated with, endorsed by or connected to Personio SE. "Personio" and related marks belong to their owners and are used here for identification only.

⚖️ Is it legal to scrape this data?

This actor reads only publicly published job-posting data — no private or personal user data. Your results can still contain personal data (e.g. a name in a description); personal data is protected by the GDPR and similar laws, so only process it with a legitimate basis. See Apify's blog post on the legality of web scraping.

🤝 Support & contact

• 🌐 Website: data.foxlabs.com.tr
• 📧 Email: info@foxlabs.com.tr
• 🐛 Issues: open a ticket in the Actor's Issues tab
• 🧰 More clean B2B data actors: Fox Labs on Apify

Changelog

0.4.2 — 2026-09-06

• Added recruitingCategory. Personio's human-readable role category (100% of roles), distinct from the coded occupationCategory slug.

0.4.1 — 2026-09-06

• Fixed includeRaw. Turning on includeRaw previously failed the whole run with "Converting circular structure to JSON" — the actor attached the raw XML DOM node (which holds circular parent/child references). Each position is now parsed into a plain field object, so includeRaw returns a clean, serialisable record and the default (includeRaw: false) run is unchanged.

0.4 — 2026-09-06

• Enabled AI-agent payments (x402). Standby mode was removed because Apify's x402 agentic-payment eligibility requires it off; the actor now runs as a standard pay-per-event run that agents can discover, run and pay for over x402 (USDC on Base) or Skyfire without an Apify account. Batch and MCP usage are unchanged.

0.3 — 2026-09-05

• Output schema linked in actor.json (output field) so the Store shows the Output tab.
• Standby mode (real-time API). The actor now also runs as an always-on HTTP API: GET /search?query=<query>&maxResults=N returns open roles as JSON, billed per role (pay-per-event). Batch runs are unchanged. Endpoint and OpenAPI schema appear in the Standby tab.

0.2 — 2026-09-05

• Added posted date. postedAt is now populated from the feed's createdAt.
• Removed columns the feed never provides: team, city, countryName, salary, updatedAt. Every emitted column now carries real data.
• Descriptions: Personio's public /xml feed ships an empty <jobDescriptions/> (the free-text advert is only on each job's HTML page). Rather than risk Personio's aggressive IP rate-limiting with a request per job, this actor returns the rich structured classification (department, seniority, schedule, yearsOfExperience, occupationCategory, subcompany, employmentType, location) instead of a description.

0.1

• Initial release: positions from any Personio XML feed.