How to use it: 3 steps
- Make a free Apify accountApify is the cloud platform where our tools run. The free plan gives you $5 of usage every month, no credit card needed. You pay Apify, not us.
- Paste your input and press StartNo code needed: you fill in a form (the input). It already has a working example. For example:
teamativein Personio board names or URLs. Each start is one run. - Download the resultsWhen the run ends, the results are in a table (the dataset). Open Output, press Export and pick Excel or CSV. JSON and the API are there too.
This tool is an Apify Actor: a small program that runs on Apify. You can also run it on a schedule, for example every Monday. New to it? Read how it works, step by step and the 8 words you need first.
What it does
Watch known Personio boards for new, changed and removed jobs. This Personio jobs scraper reads public XML feeds and saves job rows or change events. It keeps the last complete board state when a check fails, so a failed check does not report every old job as removed.
Who uses it
HR tech and job boards
Keep a current list of vacancies from Personio companies.
B2B sales teams
Watch European companies for new roles as a buying signal.
Analysts
Compare locations and published pay across several boards.
Price
Pay per event: you pay for each result the tool saves, plus a small start fee for each run. The price includes Apify platform costs. Apify bills you, not us. Prices below are for the Apify free plan.
| What you pay for | Price | When |
|---|---|---|
| Complete board check | $0.018 | One complete successful Personio board check, including a valid empty feed. |
| Saved current job | $0.00045 | One unique saved baseline, new, changed or requested unchanged job from a complete board. Removed/failed/truncated results have no event fee. Platform usage may be charged separately as shown in Pricing. |
Examples
- One job: about $0.02.
- 1,000 jobs: about $0.47.
- Every day 100 jobs, for 30 days: about $1.89 a month.
Free to try: the Apify free plan gives you $5 of usage every month, no credit card needed. That is enough for about 10,000 jobs.
Prices checked on 24 October 2026. See the current price on Apify.
Questions
Do I need a Personio account?
No. The tool reads known public XML boards only. It reads no applicant data.
Can I use a job link or custom domain?
No. Use the board name or the Personio board or XML URL.
Why does my first change run show every job?
There is no saved state yet. That first run becomes the baseline.
What happens when a check fails?
The tool keeps the last complete state. Old jobs are not marked as removed.
Does removed mean the company filled the job?
No. It means the ID disappeared from a complete accepted feed. The employer may have hidden, moved or removed the listing for another reason.
Why is the first delta a baseline?
There is no prior complete board snapshot under this key and language. Later delta runs compare with the saved state. Changing the key starts a new comparison.
Does snapshot mode affect my monitor?
Yes. A complete snapshot updates the selected state record. Use a separate key for an export that should not move your delta baseline.
Is createdAt the job's last change date?
No. It is the source creation value. updatedAt remains null. changed events compare content; they do not supply an employer update timestamp.
Are all fields always filled?
No. Null means the mapped value is absent or not safe to use. Empty arrays mean no values were supplied. Optional event timestamps can be absent. A job row with null source fields is different from a failed board fetch.
Are repeated runs free if no jobs change?
No free-run promise is made. Source checks and state work still use platform resources. Check the Pricing tab and run usage.
Details
Step by step on Apify
- Open the Actor you have access to in Apify Console, then open Input.
- Switch to JSON input and paste the minimal example below. Use a tenant from the company public Personio careers board, such as
teamative. A job title or search word such asmediabuyeris not a verified tenant. - Keep
languageas en and choose snapshot for this first check. - Click Start. Wait for the run to finish.
- Open Output or the run's default Dataset. Check
tenant,jobId,titleandeventType. - Open the default Key-value store and read
RUN_SUMMARY. Check each board'sstatusandcomplete.
Use cases
| Buyer task | Input | Key fields | Next step |
|---|---|---|---|
| Keep a current vacancy list | snapshot on known boards | tenant, jobId, title, publicUrl | Export JSON or CSV; replace your current list only from complete boards. |
| Track added or edited jobs | delta with a stable stateKey | eventType, changedFields, contentHash | Upsert by tenant + jobId in your database. |
| Mark a job as no longer listed | delta with complete source | removedAt, previousObservedAt, jobId | Archive the saved role; keep its last-known content. |
| Check locations and published pay | either mode | allLocations, salaryInformation | Filter these values in your own worksheet or application. |
Tips for better results
- A plain board name points to jobs.personio.de. Use a full URL for .com boards.
- Pick the job text language with the language setting, for example en or de.
- Use a separate state key for one-off exports. Your monitor baseline stays safe.
Limits and good to know
Input safety caps are 50 boards, 5000 positions per board and 10 MiB per response. Real Cloud checks covered up to 22 current jobs across 3 boards at 256 MB. A local synthetic test accepted 5000 positions on one board. The local test is not a Cloud capacity or throughput guarantee. Start small and inspect the results for your source.
Troubleshooting
| Symptom | Likely reason | Check | Safe next action |
|---|---|---|---|
| Input error before requests | Bad board shape, duplicate board, reserved state key or unknown field | Input and top-level errorClass | Use the exact fields and valid board root URL. |
| Failed run with redirect_blocked | The tenant redirects away from its XML feed | RUN_SUMMARY and the company careers board | Use the actual public company tenant. Redirects stay blocked. Previous state is kept. |
| Empty delta Dataset | No changes, a valid empty board, or failed checks | terminalOutcome, status, domainStatus, complete | For no changes do nothing; for failure fix the input/source and retry. |
| descriptionText is null | Employer has no text in the requested language | descriptionSections and public source | Try the employer's language with a separate monitor key if desired. |
| Posted time is null but createdAt is filled | No explicit timezone or invalid source date | Original createdAt string | Keep the source value; do not invent a timezone. |
| Truncated status | Feed exceeds maxJobsPerBoard | cap and jobCount | Raise the cap within its range; previous complete state stays intact. |
| body_cap / timeout | Response is too large or slow | maxBodyBytes, boardTimeoutMs and attemptLog | Raise the relevant bound within the input range, then test one board. |
| not_found / access_block / schema_drift | Wrong board, denied access or changed XML | sourceUrl and safe errorMessage | Check the public board; report a reproducible source change. Do not treat it as all jobs removed. |
For developers
Sample result
One result from a real test run, in JSON. Real values change from run to run. In Excel or CSV each field is a column.
{
"_type": "job",
"_schemaVersion": "1.0",
"_source": "personio",
"tenant": "teamative",
"jobId": "2681315",
"title": "Junior SAP Funkčný Konsultant – SAP CE / SAP IS-U",
"publicUrl": "https://teamative.jobs.personio.de/job/2681315",
"applyUrl": null,
"subcompany": "teamative Slovakia s.r.o.",
"office": "SK - Bratislava",
"additionalOffices": [
"SK - Košice"
],
"department": "Delivery",
"recruitingCategory": "SK - application process IT/SAP",
"employmentType": "permanent",
"seniority": "entry-level",
"schedule": "full-time",
"yearsOfExperience": "1-2",
"keywords": [
"SAP IS-U,SAP CE,ISU,CE,Junior"
],
"occupation": "enterprise_software_implementation_consulting",
"occupationCategory": "it_software",
"createdAt": "2026-06-22T11:07:27+00:00",
"descriptionSections": [],
"descriptionText": null,
"salaryInformation": {
"minimum": 2000,
"maximum": null,
"currency": "EUR",
"period": "monthly"
},
"company": "teamative",
"url": "https://teamative.jobs.personio.de/job/2681315",
"location": "SK - Bratislava",
"allLocations": [
"SK - Bratislava",
"SK - Košice"
],
"postedAt": "2026-06-22T11:07:27.000Z",
"commitment": "Full-time",
"team": null,
"country": null,
"workplaceType": null,
"updatedAt": null,
"observedAt": "2026-10-01T11:43:33.910Z",
"contentHash": "6b6d47abef37ae0392319d40644adbbefd20f280ac210875376111463339dbfe",
"_scrapedAt": "2026-10-01T11:43:33.910Z",
"eventType": "baseline",
"changedFields": []
}Use it from code
Actor ID: cliqtomedia/personio-jobs-monitor-scraper. You need your Apify API token from Apify Console → Settings → API & Integrations.
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("cliqtomedia/personio-jobs-monitor-scraper").call(run_input={
"boards": [
"teamative"
],
"language": "en"
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)curl -X POST "https://api.apify.com/v2/acts/cliqtomedia~personio-jobs-monitor-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"boards": ["teamative"], "language": "en"}'# pip install langchain-apify
# set APIFY_TOKEN in your environment
from langchain_apify import ApifyActorsTool
tool = ApifyActorsTool("cliqtomedia/personio-jobs-monitor-scraper")
result = tool.invoke({"run_input": {"boards": ["teamative"], "language": "en"}})
print(result)The cURL call waits for the results, up to 300 seconds. For longer runs, start a run (/runs) and get the results with a webhook or by checking the run. Apify API docs. LlamaIndex, MCP for AI agents and the JavaScript client: AI agents & MCP.
Data fields (40)
| Field | Type | Meaning |
|---|---|---|
_type | string | Stable record type marker. |
_schemaVersion | string | Job record schema version. |
_source | string | Upstream source marker. |
tenant | string | Canonical Personio tenant slug. |
jobId | string | Stable upstream job identifier. |
title | string | Public job title. |
publicUrl | string | Canonical public job URL. |
applyUrl | string | Public application URL when supplied. |
subcompany | string | Public subcompany value when supplied. |
office | string | Primary public office value when supplied. |
additionalOffices | array | Additional public office values. |
department | string | Public department value when supplied. |
recruitingCategory | string | Public recruiting category when supplied. |
employmentType | string | Public employment type when supplied. |
seniority | string | Public seniority value when supplied. |
schedule | string | Public schedule value when supplied. |
yearsOfExperience | string | Public experience requirement when supplied. |
keywords | array | Normalized public keyword values. |
occupation | string | Public occupation value when supplied. |
occupationCategory | string | Public occupation category when supplied. |
createdAt | string | Public upstream creation timestamp when supplied. |
descriptionSections | array | Structured public description sections. |
descriptionText | string | Normalized public description text when supplied. |
salaryInformation | object | Public salary information when supplied. |
eventType | string | Delta event classification. |
observedAt | string | UTC observation timestamp. |
changedFields | array | Job fields that changed for a changed event. |
contentHash | string | Deterministic content hash used for comparisons. |
previousObservedAt | string | Previous observation timestamp for a changed event. |
removedAt | string | Removal observation timestamp for a removed event. |
company | string | Canonical tenant alias for existing consumers. |
url | string | Validated public job URL alias. |
location | string | Primary source office alias. |
allLocations | array | Unique source offices, primary first; null when absent. |
postedAt | string | UTC source creation timestamp when timezone is explicit; null otherwise. |
commitment | string | Source schedule with initial uppercase, compatible with the leader. |
_scrapedAt | string | UTC timestamp of this extraction, excluded from content hash. |
team | null | Not exposed as a dedicated source field; never inferred. |
country | null | Not exposed as a dedicated source field; never inferred. |
workplaceType | null | Not exposed as a dedicated source field; never inferred. |
Input settings (9)
The main fields of the input form. With the API you send them as JSON.
| Setting | Name in the API | Type | Example value |
|---|---|---|---|
| Personio board names or URLs required | boards | array | ["teamative"] |
| Job text language | language | string | "en" |
| Snapshot or changes | mode | string | "snapshot" |
| Jobs allowed per board | maxJobsPerBoard | integer | 100 |
| XML size limit (bytes) | maxBodyBytes | integer | 10485760 |
| Time limit per board (ms) | boardTimeoutMs | integer | 30000 |
| Request attempts per board | maxAttempts | integer | 3 |
| Monitor state key | stateKey | string | "PERSONIO_UI_DEMO_TEAMATIVE_EN" |
| Show unchanged jobs | includeUnchanged | boolean | false |
Use cases with this tool
Each guide shows all the steps and the other tools.