# Recruitee Jobs Scraper - Live Jobs API (`mistlike_potato/recruitee-jobs-scraper`) Actor

Live job postings from 2,400+ Recruitee job boards (popular in Europe): title, location, remote, department, salary when listed, full description. Name companies or search all boards. Only-new mode.

- **URL**: https://apify.com/mistlike_potato/recruitee-jobs-scraper.md
- **Developed by:** [Ali Erciyas](https://apify.com/mistlike_potato) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 60.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 job postings

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

## Recruitee Jobs Scraper - live jobs from 2,400+ Recruitee job boards

This version reads **Recruitee** job boards (recruitee.com) only. Need all 10 platforms (Greenhouse, Lever, Ashby, SmartRecruiters and more) in one tool? Use [Career Site Jobs Scraper](https://apify.com/mistlike_potato/career-site-jobs-scraper).

Get **live job postings straight from Recruitee career sites**. This Actor reads the public Recruitee job feeds and returns one clean, unified record per job: title, company, locations, country, remote/hybrid/on-site, employment type, salary range, posting date, apply link and the full description.

- **2,414 Recruitee job boards** in the built-in directory with about **38,000 open jobs**, checked live in November 2026
- **Always live:** every run reads the company's own feed at that moment. No stale database, no expired jobs
- **$3 per 1,000 jobs.** Jobs your filters skip cost nothing

No login, no cookies, no browser. The Actor reads the same public feeds that companies publish so their jobs can be listed.

### What can I do with it?

- **Job boards and aggregators:** backfill and refresh direct-from-employer jobs with apply links
- **Job alerts and newsletters:** schedule it daily with "Only new jobs" and get just what was posted since the last run
- **Sales and lead generation:** hiring is a buying signal. See which companies hire for which roles, and where
- **Recruiting and talent intelligence:** follow competitors' openings, teams, locations and published pay
- **Salary research:** compare published pay ranges by role, company, city or country
- **AI agents and RAG:** compact JSON with plain-text descriptions, ready for LLMs. Works through the Apify MCP server

### Three ways to use it

#### 1. Jobs from the companies you name

Give company names, job-board links or `ats:slug` tokens. Names are matched against the built-in directory; unknown names are checked live.

```json
{
    "companies": ["https://bunq.recruitee.com", "recruitee:bunq"],
    "keywords": ["data scientist", "machine learning"],
    "maxItems": 200
}
```

#### 2. Search every company in the directory

Turn on **Search all companies**. The Actor sweeps the directory live, largest boards first, and stops when it has enough jobs.

```json
{
    "searchAllCompanies": true,
    "keywords": ["rust engineer"],
    "workplaceTypes": ["remote"],
    "postedWithinDays": 14,
    "maxItems": 100
}
```

#### 3. A daily feed of new jobs

Add `"onlyNew": true` and schedule the Actor. It remembers what it already delivered and returns only jobs it has not delivered before, so you never pay twice for the same job.

```json
{
    "searchAllCompanies": true,
    "keywords": ["account executive"],
    "locations": ["DE", "AT", "CH"],
    "onlyNew": true
}
```

### Input

| Field | What it does |
|---|---|
| `companies` | Company names, job-board links or `ats:slug` tokens |
| `keywords` | Title keywords. Any entry may match; words inside one entry must all appear. `"quoted"` = exact phrase |
| `locations` | Cities, regions, countries, 2-letter country codes (`US`, `DE`) or `Remote` |
| `maxItems` | Maximum jobs to save in this run |
| `searchAllCompanies` | Sweep the built-in directory, largest boards first |
| `ats` | Limit to some platforms, e.g. `["greenhouse", "ashby"]` |
| `maxBoards` | How many directory boards a sweep may read (default 2,000) |
| `excludeKeywords` | Skip titles that match, e.g. `senior`, `intern` |
| `searchDescription` | Also match keywords in the description |
| `workplaceTypes` | `remote`, `hybrid`, `onsite` |
| `employmentTypes` | `full_time`, `part_time`, `contract`, `temporary`, `internship` |
| `departments` | Department or team contains one of these |
| `postedWithinDays` | Only jobs first published in the last N days |
| `onlyWithSalary` | Only jobs with a published pay range |
| `maxItemsPerCompany` | Cap per company (sweeps use 25 by default) |
| `includeDescription`, `descriptionFormat` | Full description as plain text, HTML or both |
| `onlyNew`, `stateKey` | Deliver only jobs not delivered before |

### Output

One item per job. Example (description shortened):

```json
{
    "id": "ashby:ramp:34413f8d-26bf-4bbc-8ade-eb309a0e2245",
    "ats": "ashby",
    "company": "Ramp",
    "companySlug": "ramp",
    "title": "Software Engineer, Security, Cloud",
    "department": "Engineering",
    "team": "Security",
    "location": "New York, NY (HQ)",
    "locations": ["New York, NY (HQ)"],
    "country": "US",
    "workplaceType": "hybrid",
    "employmentType": "full_time",
    "seniority": null,
    "salaryMin": 211400,
    "salaryMax": 290600,
    "salaryCurrency": "USD",
    "salaryPeriod": "year",
    "salaryText": "$211.4K - $290.6K",
    "salarySource": "ats",
    "postedAt": "2026-04-07T17:12:35.753Z",
    "updatedAt": null,
    "url": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245",
    "applyUrl": "https://jobs.ashbyhq.com/ramp/34413f8d-26bf-4bbc-8ade-eb309a0e2245/application",
    "boardUrl": "https://jobs.ashbyhq.com/ramp",
    "requisitionId": null,
    "descriptionText": "ABOUT RAMP\n\nRamp is building ...",
    "scrapedAt": "2026-11-15T21:00:00.000Z"
}
```

Notes on fields:

- `workplaceType`, `employmentType`, `salary*` come from the ATS when it publishes them. If it does not, salary is read from the description only when a clear range is stated (`salarySource: "text"`).
- `country` is an ISO 3166-1 alpha-2 code, set when the posting makes it clear.
- `seniority` is read from the title with fixed rules. No AI guesses anywhere.
- A run summary (boards read, boards unavailable, names that could not be resolved) is stored under the key `SUMMARY` in the run's key-value store.

### Pricing

Pay per event, no subscription:

- **$3 per 1,000 jobs** saved to your dataset
- **$0.05 per 1,000 company boards searched**, only when you use "Search all companies" (a default sweep of 2,000 boards is $0.10)
- A tiny start fee per run (Apify's standard `apify-actor-start`)

Jobs skipped by your filters, jobs already delivered in "Only new jobs" mode, unavailable boards and errors cost nothing. Set **Max jobs** to cap what a run can cost.

### Tips

- Combine `searchAllCompanies` with keywords or locations. A sweep without filters returns the largest employers first.
- Raise `maxBoards` for rare keywords. The default sweep reads the 2,000 largest boards.
- For a monitor, schedule the same input daily with `onlyNew`. Use `stateKey` to give several schedules their own memory.

### FAQ

**Where does the data come from?** From the public job feeds of each company's applicant tracking system, the same feeds that power the company's career page. Nothing behind a login is touched.

**Is it legal?** The Actor reads public job advertisements that employers publish to be found. It collects no private data. You are responsible for how you use the results, including the terms of the sites you publish to.

**A company is missing or a board fails.** Pass the job-board link in `companies`. If it still fails, open an issue on the Issues tab with the link and it will be looked at.

**Why are some fields empty?** Each ATS publishes different fields. Greenhouse, for example, rarely states the employment type.

### Credits

The built-in directory was seeded from the open company lists of [stapply-ai/ats-scrapers](https://github.com/stapply-ai/ats-scrapers) (MIT License, © 2026 Kalil Bouzigues), which draw on [latmay/ats-career-page-urls](https://huggingface.co/datasets/latmay/ats-career-page-urls) (CC BY 4.0) and the Common Crawl URL index. Every board was then checked live and ranked by its number of open jobs.

This Actor is not affiliated with Greenhouse, Lever, Ashby, SmartRecruiters, Personio, Recruitee, Teamtailor, Rippling, Gem or Breezy HR.

# Actor input Schema

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

Company names (Stripe, Airbnb), job-board links (https://job-boards.greenhouse.io/stripe, https://jobs.lever.co/spotify, https://jobs.ashbyhq.com/ramp) or tokens like greenhouse:stripe. Names are matched against the built-in directory; unknown names are checked live. Leave empty and turn on "Search all companies" to search the whole directory.

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

A job matches if its title contains ANY entry. Words inside one entry must all appear ("data analyst" also finds "Analyst, Data Platform"). Put an entry in double quotes for an exact phrase. Leave empty for every job.

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

Cities, regions or countries as written in postings (Berlin, California, United Kingdom), a 2-letter country code (US, DE, AT) or Remote. A job matches if ANY entry matches.

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

Maximum number of jobs to save (and pay for) in this run. Leave empty for no limit.

## `searchAllCompanies` (type: `boolean`):

Search the built-in directory of company job boards live, largest boards first, in addition to any companies listed above. Best combined with keywords and/or locations. The sweep stops as soon as "Max jobs" is reached.

## `maxBoards` (type: `integer`):

Upper limit for "Search all companies": how many company boards to read, largest first. Higher = wider coverage and a longer run.

## `excludeKeywords` (type: `array`):

Skip jobs whose title matches any of these, e.g. senior, manager, intern.

## `searchDescription` (type: `boolean`):

Match keywords against the job description too (for skills such as SQL or Kubernetes), not only the title.

## `workplaceTypes` (type: `array`):

Only remote, hybrid or on-site jobs. Jobs that do not state an arrangement count as on-site.

## `employmentTypes` (type: `array`):

Jobs whose feed does not state a type are left out when this is set.

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

Only jobs whose department or team contains one of these, e.g. Engineering, Sales, Finance.

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

Only jobs first published in the last N days.

## `onlyWithSalary` (type: `boolean`):

Keep only jobs that publish a pay range (from the feed, or clearly stated in the description).

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

Cap per company, so one large employer does not fill the whole run.

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

Adds the full description. Turn off for a faster, lighter list of titles, locations, salaries and links.

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

Plain text is best for AI and search. HTML keeps the original formatting.

## `onlyNew` (type: `boolean`):

Remembers which jobs this search already delivered (in a key-value store in your account) and saves only jobs it has not delivered before. Schedule the Actor daily for a new-jobs feed. You never pay twice for the same job.

## `stateKey` (type: `string`):

Optional. Each distinct search keeps its own memory automatically. Set a name to share one memory across searches or to start a fresh one.

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

Company boards read in parallel.

## Actor input object example

```json
{
  "companies": [
    "https://bunq.recruitee.com",
    "recruitee:bunq"
  ],
  "keywords": [
    "engineer"
  ],
  "maxItems": 50,
  "searchAllCompanies": false,
  "maxBoards": 2000,
  "searchDescription": false,
  "onlyWithSalary": false,
  "includeDescription": true,
  "descriptionFormat": "text",
  "onlyNew": false,
  "maxConcurrency": 16
}
```

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

// Prepare Actor input
const input = {
    "companies": [
        "https://bunq.recruitee.com",
        "recruitee:bunq"
    ],
    "keywords": [
        "engineer"
    ],
    "maxItems": 50
};

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

# Prepare the Actor input
run_input = {
    "companies": [
        "https://bunq.recruitee.com",
        "recruitee:bunq",
    ],
    "keywords": ["engineer"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("mistlike_potato/recruitee-jobs-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": [
    "https://bunq.recruitee.com",
    "recruitee:bunq"
  ],
  "keywords": [
    "engineer"
  ],
  "maxItems": 50
}' |
apify call mistlike_potato/recruitee-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,mistlike_potato/recruitee-jobs-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/m2zK1PWX7A3jmJvBN/builds/WNlVAUd78TXR0QQUD/openapi.json
