# ATS Job Listings: Personio, Teamtailor, Workable, Recruitee (`datlab/ats-job-listings`) Actor

Get open jobs from company career sites on Personio, Teamtailor, Workable and Recruitee in one unified, PII-free format. Paste careers URLs or company slugs and filter by keyword, location, department or remote.

- **URL**: https://apify.com/datlab/ats-job-listings.md
- **Developed by:** [DatLab](https://apify.com/datlab) (community)
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 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/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

## ATS Job Listings Scraper: Personio, Teamtailor, Workable, Recruitee

An **ATS job scraper** for public career pages: get **every open job** from company sites that run on **Personio, Teamtailor, Workable or Recruitee**, all in one clean, unified, **PII-free** format. Paste careers-page URLs or company slugs — **no login** required. The Actor detects the platform, reads the company's **official public job feed** (Personio, Teamtailor, Workable and Recruitee career pages / public jobs APIs) and returns structured jobs you can filter by keyword, location, department, remote status and posting date.

- ✅ **4 ATS platforms, 1 schema**: the same fields whichever ATS a company uses
- ✅ **Auto-detection** from any careers URL, including custom domains (`careers.company.com`)
- ✅ **No browser, no proxies needed**: lightweight HTTP requests to public feeds, so it's fast and cheap
- ✅ **Privacy-safe output**: recruiter / hiring-manager names, emails and phone numbers are removed
- ✅ Optional **full job descriptions** (plain text or sanitized HTML)

### Use cases

- Track hiring at target accounts (sales intelligence, "who is hiring engineers in Berlin?")
- Build niche job boards and job alerts
- Labour-market and competitor research
- Feed HR-tech / recruiting tools with fresh postings

### Input

| Field | Description |
|---|---|
| `careersUrls` | Any careers URL. The platform is auto-detected. |
| `personioCompanies` / `teamtailorCompanies` / `workableCompanies` / `recruiteeCompanies` | Company slugs (or URLs) per platform |
| `keywords` | Match ANY word in the title/department (and description if included) |
| `locations`, `departments` | Substring filters (ANY) |
| `remoteOnly`, `postedWithinDays` | Remote-only and recency filters |
| `maxItems`, `maxItemsPerCompany` | Result caps (`0` = unlimited) |
| `includeDescription`, `descriptionFormat` | Add the job description as `text`, `html` or `both` |

Example:

```json
{
  "careersUrls": ["https://checkmk-gmbh.jobs.personio.de/", "https://apply.workable.com/ottimate/"],
  "teamtailorCompanies": ["agilelab"],
  "recruiteeCompanies": ["trackman"],
  "keywords": ["engineer", "developer"],
  "remoteOnly": false,
  "maxItems": 100,
  "includeDescription": true
}
```

#### Where do I find the slug?

| Platform | Careers URL | Slug |
|---|---|---|
| Personio | `https://checkmk-gmbh.jobs.personio.de` | `checkmk-gmbh` |
| Teamtailor | `https://agilelab.teamtailor.com` | `agilelab` |
| Workable | `https://apply.workable.com/ottimate/` | `ottimate` |
| Recruitee | `https://trackman.recruitee.com` | `trackman` |

Not sure? Just paste the URL into `careersUrls`.

### Output

One dataset item per job:

```json
{
  "platform": "personio",
  "company": "Checkmk GmbH",
  "companySlug": "checkmk-gmbh",
  "jobId": "2824650",
  "title": "Billing Specialist (m/f/d)",
  "department": "Finance & Risk",
  "location": "Munich; Remote",
  "country": null,
  "remote": true,
  "workplaceType": "remote",
  "employmentType": "full-time, permanent",
  "postedAt": "2026-10-02T09:55:41.000Z",
  "url": "https://checkmk-gmbh.jobs.personio.de/job/2824650",
  "description": "Your mission\n\n * Invoicing: You are responsible for invoicing all of our business lines …",
  "scrapedAt": "2026-10-28T23:37:06.732Z"
}
```

| Field | Notes |
|---|---|
| `platform` | `personio` · `teamtailor` · `workable` · `recruitee` |
| `workplaceType` | `remote` · `hybrid` · `onsite` · `null` (when the ATS doesn't say) |
| `country` | ISO-3166 alpha-2 when the ATS provides it (Personio feeds don't) |
| `employmentType` | As labelled by the ATS (Teamtailor's feed has none, so it's `null`) |
| `postedAt` / `scrapedAt` | ISO 8601, UTC |
| `description` / `descriptionHtml` | Only when `includeDescription` is on |

A `RUN_SUMMARY` record in the key-value store lists every company with jobs found and saved, plus status (for example "public feed disabled").

#### Data coverage by platform

| | Personio | Teamtailor | Workable | Recruitee |
|---|---|---|---|---|
| Department | ✅ | ✅ | ✅ | ✅ |
| Location / country | ✅ / – | ✅ / ✅ | ✅ / ✅ | ✅ / ✅ |
| Remote / hybrid | remote only (from office names) | ✅ | remote only | ✅ |
| Employment type | ✅ | – | ✅ | ✅ |
| Description | ✅ | ✅ | ✅ | ✅ |

### Pricing

This Actor uses **pay per result**: **$1.50 per 1,000 jobs** ($0.0015 per job in the dataset). You don't pay extra for companies with no open jobs or feeds that fail, because only returned job rows are charged.

- 100 jobs ≈ $0.15, 1,000 jobs = $1.50, 10,000 jobs = $15
- Filters (`keywords`, `locations`, `remoteOnly`, `postedWithinDays` …) are applied **before** results are saved, so you only pay for jobs that match.
- Set **Maximum cost per run** in the run options to cap spending.
- Apify's free plan includes monthly credit you can use to try it.

The live price list is on the **Pricing** tab of this page.

### FAQ

**Which companies does it work for?**
Any company whose careers site runs on Personio, Teamtailor, Workable or Recruitee, including custom domains like `careers.company.com`. Paste the careers URL and the platform is detected automatically.

**Do I need an account, API key or proxy?**
No. It reads the public job feeds each ATS publishes for job boards and aggregators.

**How fresh is the data?**
Live: every run reads the current feed, so you get the jobs that are open right now. Schedule it (e.g. daily) to track new postings.

**Can I get the full job description?**
Yes. Turn on `includeDescription` and choose plain text or sanitized HTML with `descriptionFormat`.

**Why does a company return 0 jobs?**
It may have no open positions, or it switched its public feed off. `RUN_SUMMARY` shows the status for each company.

**Can I export to CSV, Excel or Google Sheets?**
Yes. Download the dataset as JSON, CSV, Excel or XML, or use Apify integrations (Make, Zapier, Google Sheets, webhooks, API).

### Privacy

This Actor only outputs information about the **job**, never about people:

- Structured person fields the ATS exposes are never read (e.g. Recruitee `mailbox_email`). Neither are office street addresses or postcodes (Teamtailor).
- Emails and phone numbers inside descriptions are removed. So are `mailto:`/`tel:` links, labelled contact lines ("Your contact: …", "Ansprechpartnerin: …") and contact sentences ("please contact Jane Doe at …").
- Removing free text is heuristic. Plain-text output gets the strictest cleaning; HTML output is best-effort.

### Limits & tips

- A company can disable its public feed (Teamtailor/Personio). It then appears in `RUN_SUMMARY` with an HTTP 404 or "no open positions".
- Workable sometimes lists the same job once per location. Results are deduplicated by job ID.
- Requests are rate-limited politely (default 60/min overall and at most ~2/s per site).

### Legal & data use

- The Actor reads only **public** job feeds that companies publish so their jobs can be listed on job boards. It doesn't log in or bypass access controls, and it rate-limits its requests politely.
- It's built to return **job data, not personal data**. Contact details are stripped (see Privacy), but job descriptions are free text written by the employer, so check the output before you reuse it.
- Job posts remain the content of the employers. You're responsible for using the data in line with applicable law (e.g. GDPR) and the terms of the sites involved.
- Not affiliated with or endorsed by Personio, Teamtailor, Workable or Recruitee.

### Running on Apify

You can run this Actor on the Apify platform from the Console, the API, a schedule, integrations (webhooks, Slack, Google Sheets, Make, Zapier) or MCP.

### Other DatLab actors

- [Web Page to Markdown](https://apify.com/datlab/web-page-to-markdown) — turn a list of URLs into Markdown for LLMs and RAG
- [Website to Markdown Crawler](https://apify.com/datlab/site-to-markdown-crawler) — crawl a site into Markdown, with sitemaps and llms.txt
- [Sitemap Change Monitor](https://apify.com/datlab/sitemap-change-monitor) — extract sitemap URLs and watch new, removed and updated pages
- [SAM.gov Contract Opportunities](https://apify.com/datlab/sam-gov-contract-opportunities) — US federal opportunities from the official daily extract, no API key

# Actor input Schema

## `careersUrls` (type: `array`):

Any careers page URL. The ATS is detected automatically: jobs.personio.de/.com, \*.teamtailor.com, apply.workable.com/…, \*.recruitee.com, or a company's own careers page that embeds or is hosted by one of these.

## `personioCompanies` (type: `array`):

Personio subdomains, e.g. <code>checkmk-gmbh</code> for checkmk-gmbh.jobs.personio.de. Full URLs also work.

## `teamtailorCompanies` (type: `array`):

Teamtailor subdomains (<code>agilelab</code>), regional hosts (<code>workwithus.na.teamtailor.com</code>) or the company's Teamtailor-hosted custom domain.

## `workableCompanies` (type: `array`):

Workable account names, e.g. <code>ottimate</code> for apply.workable.com/ottimate.

## `recruiteeCompanies` (type: `array`):

Recruitee subdomains (<code>trackman</code>) or the company's Recruitee-hosted custom domain (<code>careers.trackman.com</code>).

## `keywords` (type: `array`):

Keep jobs whose title or department (or description, if included) contains ANY of these words. Case-insensitive.

## `locations` (type: `array`):

Keep jobs whose location/country contains ANY of these (e.g. <code>Berlin</code>, <code>Germany</code>, <code>DE</code>, <code>Remote</code>).

## `departments` (type: `array`):

Keep jobs whose department contains ANY of these (e.g. <code>Engineering</code>).

## `remoteOnly` (type: `boolean`):

Keep only jobs the ATS marks as fully remote.

## `postedWithinDays` (type: `integer`):

Keep only jobs posted in the last N days. 0 = no limit.

## `maxItems` (type: `integer`):

Stop after saving this many jobs in total. 0 = no limit.

## `maxItemsPerCompany` (type: `integer`):

0 = no limit.

## `includeDescription` (type: `boolean`):

Add the full job description. Emails, phone numbers and contact-person lines are removed.

## `descriptionFormat` (type: `string`):

Plain text, sanitized HTML, or both.

## `personioLanguage` (type: `string`):

Language code for Personio feeds (e.g. en, de). Companies that did not translate a job return their default language.

## `maxRequestsPerMinute` (type: `integer`):

Politeness limit across all sites (max 120).

## `maxConcurrency` (type: `integer`):

Parallel requests (max 10).

## Actor input object example

```json
{
  "careersUrls": [
    "https://checkmk-gmbh.jobs.personio.de/",
    "https://apply.workable.com/ottimate/"
  ],
  "personioCompanies": [],
  "teamtailorCompanies": [
    "agilelab"
  ],
  "workableCompanies": [],
  "recruiteeCompanies": [
    "trackman"
  ],
  "keywords": [],
  "locations": [],
  "departments": [],
  "remoteOnly": false,
  "postedWithinDays": 0,
  "maxItems": 100,
  "maxItemsPerCompany": 0,
  "includeDescription": false,
  "descriptionFormat": "text",
  "personioLanguage": "en",
  "maxRequestsPerMinute": 60,
  "maxConcurrency": 3
}
```

# Actor output Schema

## `results` (type: `string`):

All dataset items produced by the run.

## `runSummary` (type: `string`):

RUN_SUMMARY record with per-source status, counts and timing.

# 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 = {
    "careersUrls": [
        "https://checkmk-gmbh.jobs.personio.de/",
        "https://apply.workable.com/ottimate/"
    ],
    "teamtailorCompanies": [
        "agilelab"
    ],
    "recruiteeCompanies": [
        "trackman"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("datlab/ats-job-listings").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 = {
    "careersUrls": [
        "https://checkmk-gmbh.jobs.personio.de/",
        "https://apply.workable.com/ottimate/",
    ],
    "teamtailorCompanies": ["agilelab"],
    "recruiteeCompanies": ["trackman"],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("datlab/ats-job-listings").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 '{
  "careersUrls": [
    "https://checkmk-gmbh.jobs.personio.de/",
    "https://apply.workable.com/ottimate/"
  ],
  "teamtailorCompanies": [
    "agilelab"
  ],
  "recruiteeCompanies": [
    "trackman"
  ],
  "maxItems": 100
}' |
apify call datlab/ats-job-listings --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datlab/ats-job-listings"
        }
    }
}
```

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/O4qrJDpom6Z9l8NqY/builds/XL1yHMZsrU6nXTDUz/openapi.json