# Werkzoeken.nl Jobs Scraper (`parsebird/werkzoeken-nl-jobs-scraper`) Actor

Scrape werkzoeken.nl vacatures by keyword, city, radius, salary and contract. Get title, company, salary, hours, full description, apply URL and employer info. Export JSON, CSV, Excel.

- **URL**: https://apify.com/parsebird/werkzoeken-nl-jobs-scraper.md
- **Developed by:** [ParseBird](https://apify.com/parsebird) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 vacancies

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

### Werkzoeken.nl Jobs Scraper

Werkzoeken.nl Jobs Scraper extracts vacatures from [werkzoeken.nl](https://www.werkzoeken.nl), a Dutch job site with more than 180,000 open vacancies, as structured data. Each record has the job title, company, location with coordinates, salary range, hours, contract type, full description, apply URL, benefits, tasks, requirements, and employer details.

<table><tr>
<td style="border-left:4px solid #1C1917;padding:12px 16px;font-weight:600">
Search werkzoeken.nl by keyword, city or postcode with a radius, monthly salary, hours per week, contract type, education, experience, working times, company type and size, benefits, and "CV niet verplicht", then track new, updated, and expired vacancies across scheduled runs.
</td>
</tr></table>

##### Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

```text
Apify Actor parsebird/werkzoeken-nl-jobs-scraper scrapes vacancies from werkzoeken.nl (Netherlands). Call it with the apify-client package: client.actor("parsebird/werkzoeken-nl-jobs-scraper").call(run_input={"queries": ["kok"], "locations": ["Amsterdam"], "radiusKm": 10, "contractTypes": ["permanent"], "salaryMin": 2800, "maxResults": 100}). Inputs: queries (array of keywords; empty = all vacancies), locations (array of Dutch cities, postcodes, regions or provinces), radiusKm (int 0-500, default 30), startUrls (array of werkzoeken.nl search URLs /vacatures/?..., /vacatures-voor/<job>/[<city>/] pages, or vacancy URLs /vacature/<id>-.../), maxResults (int, default 100, 0 = no limit), includeDetails (bool, default true), includeCompanyProfile (bool, default false), salaryMin (int, gross EUR per month), hoursMin / hoursMax (int 0-40), contractTypes (array: permanent, temporary, secondment, freelance, traineeship, internship), educationLevels (array: none, vmbo, mbo, hbo, university), experienceLevels (array: starter, experienced, expert), workSchedules (array: day, evening, night, weekend, shifts, irregular, on-call), companyTypes (array: direct-employer, recruitment-agency, temp-agency), companySizes (array: small, medium, large, very-large), benefits (array, e.g. pension, lease-car, travel-allowance, 13th-month, holiday-pay), noCvRequired (bool), publishedWithinDays (int), maxPagesPerSearch (int, 0 = no limit), incrementalMode (bool), stateKey (string), emitUnchanged (bool), emitExpired (bool), skipReposts (bool), compact (bool), descriptionMaxLength (int, 0 = full), proxyConfiguration (default Apify RESIDENTIAL NL). Output: one dataset item per vacancy with jobId, title, company, companyType, companyCategory, companyLogo, companyId, location, address, latitude, longitude, salaryText, salaryMin, salaryMax, salaryCurrency, salaryPeriod, hoursText, hoursMin, hoursMax, contractType, education, driversLicense, languages, workFromHome, cvRequired, benefits, tags, highlights, tasks, requirements, summary, description, descriptionHtml, descriptionMarkdown, descriptionLength, postedAgo, postedDaysAgo, dateLabel, postedDate, updatedDate, url, applyUrl, contactPerson, companySize, companyOpenVacancies, companyVerified, companyDescription, companyProfile, searchQuery, searchLocation, searchUrl, position, detailFetched, contentHash, scrapedAt; plus changeType, firstSeenAt, lastSeenAt, isRepost, repostOfId in incremental mode. API docs: https://apify.com/parsebird/werkzoeken-nl-jobs-scraper/api. Get a token: https://console.apify.com/settings/integrations
```

### What is Werkzoeken.nl Jobs Scraper?

**Werkzoeken.nl Jobs Scraper** is a data extraction tool for **werkzoeken.nl vacatures**. [Werkzoeken.nl](https://www.werkzoeken.nl) collects vacancies from direct employers, recruitment agencies, and temp agencies across the Netherlands and showed **more than 180,000 open vacancies** in November 2026. werkzoeken.nl has no public API, so this Actor is a **werkzoeken.nl API alternative**: you enter keywords, a location, and filters, and get clean JSON records instead of clicking through result pages.

The easiest way to try it: open the **Input** tab, keep the prefilled keyword `schilder` (painter), and click **Start**. You get 20 vacancies with full details in under a minute.

### What can Werkzoeken.nl Jobs Scraper do?

- 🔍 **Search by keyword**: job title, skill, or any Dutch or English word. Several keywords run as separate searches, and duplicates are removed. Leave keywords empty to browse every vacancy on werkzoeken.nl.
- 📍 **Search by location and radius**: Dutch city, postcode, region, or province, with a radius in km. Unknown places are reported and skipped, never silently widened to the whole country.
- 🎯 **Use all werkzoeken.nl filters**: minimum monthly salary, hours per week, contract type (vast, tijdelijk, detachering, freelance, traineeship, stage), education, experience, working times, company type, company size, 44 benefits, and vacancies where a CV is not required.
- 📄 **Get full vacancy details**: complete description as text, HTML, and Markdown, apply URL, address with latitude and longitude, benefits, tasks, requirements, education, driver's license, languages, the recruiter's first name, and employer facts.
- 🏢 **Add company profiles**: headquarters and branch addresses, employee range, average age, gender ratio, dress code, open vacancies per category, and the application steps.
- 🔗 **Start from URLs**: paste werkzoeken.nl search URLs, `/vacatures-voor/` job pages, or single vacancy URLs.
- 🔁 **Track changes with incremental mode**: scheduled runs return only NEW, UPDATED, and REAPPEARED vacancies, can also return EXPIRED ones, and flag reposts.
- 🤖 **Use compact output**: core fields only, so AI agents and MCP tools use fewer tokens.

On the Apify platform you also get [scheduled runs](https://docs.apify.com/platform/schedules), a full [REST API](https://docs.apify.com/api/v2), [integrations](https://apify.com/integrations) with Make, Zapier, n8n, Google Sheets, Slack, and webhooks, and export to JSON, CSV, Excel, XML, or HTML.

### What data can you extract from werkzoeken.nl?

| Field | Description |
|-------|-------------|
| `title` | Vacancy title as published |
| `company` / `companyType` / `companyCategory` | Company name, poster type (Directe werkgever, Werving en selectie, Uitzendbureau), and the label werkzoeken.nl shows under the employer |
| `location` / `address` / `latitude` / `longitude` | Work location, postcode and place, and map coordinates |
| `salaryText` / `salaryMin` / `salaryMax` / `salaryPeriod` | Salary as shown (e.g. `€ 3.400 - € 4.300 p/m`), parsed numbers in EUR, and period (MONTH, HOUR, YEAR) |
| `hoursText` / `hoursMin` / `hoursMax` | Hours per week (e.g. `32 - 40 uur` or `Fulltime`) |
| `contractType` / `education` / `experience` | Contract form, required education level, and experience |
| `driversLicense` / `languages` / `workFromHome` / `cvRequired` | Extra requirements, partial home working, and whether a CV is needed |
| `benefits` / `tasks` / `requirements` | Secondary benefits, "Wat ga je doen?" tasks, and "Wat verwachten wij?" requirements |
| `summary` / `description` / `descriptionHtml` / `descriptionMarkdown` | Short summary and the full vacancy text in three formats |
| `postedAgo` / `postedDate` / `updatedDate` | Posting age as shown, and the posting or update date |
| `url` / `applyUrl` | Vacancy page and application link |
| `contactPerson` | First name of the person who receives applications, when shown |
| `companySize` / `companyOpenVacancies` / `companyDescription` | Employer facts from the vacancy page |
| `companyProfile` | Full employer profile (with **Include company profiles**) |

In standard mode every record has the same keys. Values werkzoeken.nl does not show are `null` (or an empty list), never left out.

### How to scrape werkzoeken.nl

1. Open [Werkzoeken.nl Jobs Scraper](https://apify.com/parsebird/werkzoeken-nl-jobs-scraper) in Apify Console.
2. Enter one or more **Search keywords**, for example `kok` or `verpleegkundige`.
3. Optionally add **Locations** (city, postcode, or province) and a **Radius**.
4. Set filters such as **Minimum monthly salary**, **Contract types**, or **Education levels**.
5. Choose **Max results**, and leave **Include full details** on for descriptions and apply URLs.
6. Click **Start**, wait for the run to finish, and download the data as JSON, CSV, or Excel from the **Output** tab.

### Input example

```json
{
    "queries": ["kok"],
    "locations": ["Amsterdam"],
    "radiusKm": 10,
    "contractTypes": ["permanent"],
    "salaryMin": 2800,
    "maxResults": 100,
    "includeDetails": true
}
```

Other ways to run it:

- **Incremental tracking**: `{"queries": ["software developer"], "maxResults": 0, "incrementalMode": true, "stateKey": "developer-tracker"}`. The first run builds the baseline; later runs return only new or changed vacancies.
- **Compact output for AI agents**: `{"queries": ["receptionist"], "maxResults": 50, "compact": true}`.
- **Fast search-card data only**: `{"queries": ["magazijnmedewerker"], "includeDetails": false, "maxResults": 1000}`.
- **From URLs**: `{"startUrls": [{"url": "https://www.werkzoeken.nl/vacatures/?what=chauffeur&where=Utrecht&r=15&filtered=1"}, {"url": "https://www.werkzoeken.nl/vacature/16063249-voorman-schilder/"}]}`.

### Output example

```json
{
    "jobId": "16253332",
    "title": "Zelfstandig werkend kok | Restaurant | Volendam",
    "company": "The Keepers",
    "companyType": "Uitzendbureau",
    "companyCategory": "Uitzendbureau",
    "companyLogo": "https://cdn.werkzoeken.nl/logo_groot/1d1a7afc255375c8d186c40ad62e3883643664e00621623473c8904217b7.png",
    "companyId": "c559ee45-39e2-11ef-a6b6-00163ee78db5",
    "location": "Amsterdam",
    "address": "Amsterdam",
    "latitude": 52.36507,
    "longitude": 4.88832,
    "salaryText": "€ 2.850 - € 3.300 p/m",
    "salaryMin": 2850,
    "salaryMax": 3300,
    "salaryCurrency": "EUR",
    "salaryPeriod": "MONTH",
    "hoursText": "40 uur",
    "hoursMin": 40,
    "hoursMax": 40,
    "contractType": "Loondienst (vast)",
    "education": null,
    "languages": ["Nederlands"],
    "cvRequired": false,
    "benefits": ["Extra vakantiedagen", "Reiskostenvergoeding", "Doorgroeimogelijkheden"],
    "tags": ["40 uur", "Weekend, Overdag", "Hecht team"],
    "tasks": ["Bereiden van lunch en diner", "Zelfstandig draaien van de partie", "Bewaken van kwaliteit en hygiëne"],
    "requirements": ["Ervaring als zelfstandig werkend kok", "Zelfstandig, stressbestendig, teamplayer"],
    "summary": "In deze drukke keuken aan de haven bereid jij zelfstandig kwalitatieve gerechten voor lunch en diner. Je bewaakt de hygiëne en begeleidt tevens minder ervaren collega's.",
    "description": "Je werkt in een drukke à-la-cartekeuken van dit hechte familiebedrijf, waar kwaliteit en tempo centraal staan...",
    "descriptionMarkdown": "Je werkt in een drukke à-la-cartekeuken van dit hechte familiebedrijf...",
    "descriptionLength": 2198,
    "postedAgo": "1 week geleden",
    "postedDaysAgo": 7,
    "dateLabel": "Net bijgewerkt",
    "postedDate": null,
    "updatedDate": "2026-11-12",
    "url": "https://www.werkzoeken.nl/vacature/16253332-zelfstandig-werkend-kok-restaurant-volendam/",
    "applyUrl": "https://www.werkzoeken.nl/reageer-direct-per-email/57605/16253332/?pos=1",
    "contactPerson": "Indra",
    "companySize": "Zeer groot bedrijf",
    "companyOpenVacancies": 39,
    "companyVerified": true,
    "companyProfile": null,
    "searchQuery": "kok",
    "searchLocation": "Amsterdam",
    "detailFetched": true,
    "scrapedAt": "2026-11-12T11:48:36.719Z"
}
```

With **Include company profiles** on, `companyProfile` holds the employer profile:

```json
{
    "name": "Intro Personeel",
    "category": "Werving en selectie",
    "employeeRange": "51 - 250 medewerkers",
    "headquarters": "Schapedrift 91, 3371JJ, Hardinxveld-Giessendam",
    "branches": ["De Panoven 27A, 4191 GW, Geldermalsen", "Ambachtsweg 14a, 2964 LG, Groot-Ammers"],
    "averageAge": "26 - 35 jaar",
    "menPercent": 75,
    "womenPercent": 25,
    "dressCode": "Casual",
    "vacancyCategories": [{"category": "Bouw", "openVacancies": 150}, {"category": "Logistiek", "openVacancies": 120}],
    "applicationProcess": [{"step": "Sollicitatie beoordeling", "duration": "Duurt 1 - 2 dagen", "description": "We bekijken je sollicitatie zorgvuldig..."}]
}
```

Download the dataset in JSON, CSV, Excel, XML, or HTML from the Output tab or the API.

### Use cases

- 📊 **Labour market research**: compare salaries, hours, and contract types by job title and region in the Netherlands.
- 🧑‍💼 **Recruitment and staffing**: see which employers and agencies hire for the roles you place, with company size and open vacancy counts.
- 🔔 **Job alerts**: schedule a daily incremental run and send new vacancies to Slack, email, or Google Sheets.
- 🏢 **Competitor monitoring**: follow which roles an agency or employer publishes and when they change or disappear.
- 🤖 **AI agents and job matching**: feed compact vacancy records into an LLM, RAG pipeline, or matching model.

### How it works

1. The Actor sends your keyword, location, radius, and filters to the werkzoeken.nl vacancy search and reads the results, 50 per page.
2. It goes through the result pages until it reaches **Max results**, **Max pages per search**, or the end of the results.
3. With **Include full details** on, it opens each vacancy and its full description, 16 requests at a time. With **Include company profiles** on, it also loads each employer's profile once per run.
4. werkzoeken.nl blocks datacenter IPs, so requests go through Apify residential proxies in the Netherlands, and a blocked request is retried on a new IP.
5. Each vacancy is saved and charged as it is collected, so the run stops as soon as your spending limit is reached.

### How much does it cost to scrape werkzoeken.nl?

Werkzoeken.nl Jobs Scraper uses pay-per-event pricing. Compute and residential proxy traffic are included in the event prices, so they are not billed separately.

| Event | Price per event | Price per 1,000 |
|-------|----------------|-----------------|
| apify-actor-start | $0.005 | — (once per run) |
| job-scraped (Free plan) | $0.00129 | **$1.29** |
| job-scraped (Bronze plan) | $0.00119 | **$1.19** |
| job-scraped (Silver plan) | $0.00109 | **$1.09** |
| job-scraped (Gold plan) | $0.00099 | **$0.99** |
| job-details (Free plan) | $0.00099 | **$0.99** |
| job-details (Bronze plan) | $0.00089 | **$0.89** |
| job-details (Silver and Gold plans) | $0.00079 | **$0.79** |

`job-scraped` is charged for every vacancy saved to the dataset. `job-details` is charged on top only when the vacancy's detail page was loaded (**Include full details** on, or a vacancy URL). For example, 1,000 vacancies with full details cost $2.28 on the Free plan, and 1,000 search-card records without details cost $1.29. Vacancies skipped by **Published within**, or unchanged ones in incremental mode, are not charged. Apify's free plan includes monthly platform credit you can use for this Actor.

### Python and JavaScript API examples

Python ([apify-client](https://docs.apify.com/api/client/python)):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("parsebird/werkzoeken-nl-jobs-scraper").call(run_input={
    "queries": ["kok"],
    "locations": ["Amsterdam"],
    "radiusKm": 10,
    "contractTypes": ["permanent"],
    "maxResults": 100,
})
for job in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(job["title"], "|", job["company"], "|", job["location"], "|", job["salaryText"])
```

JavaScript ([apify-client](https://docs.apify.com/api/client/js)):

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('parsebird/werkzoeken-nl-jobs-scraper').call({
    queries: ['kok'],
    locations: ['Amsterdam'],
    radiusKm: 10,
    contractTypes: ['permanent'],
    maxResults: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((job) => console.log(job.title, job.company, job.location, job.salaryText));
```

Find all endpoints on the [API tab](https://apify.com/parsebird/werkzoeken-nl-jobs-scraper/api).

### FAQ

**Do I need a werkzoeken.nl account?**
No. The Actor reads the vacancies werkzoeken.nl shows to logged-out visitors. No login or API key is needed.

**How many vacancies can I scrape from werkzoeken.nl?**
A search returns all of its matches, 50 per page; a search for every vacancy returned more than 180,000 in November 2026. Set **Max results** to `0` to collect everything a search returns.

**Can I filter by posting date?**
werkzoeken.nl has no date filter, and results are sorted by relevance, not date. **Published within (days)** checks each result's posting date and skips older ones without charging for them, but the search still pages through all results. Combine it with **Max pages per search** to keep runs short. Ages shown in weeks ("2 weken geleden") count as their lower bound.

**Why is `postedDate` empty for some vacancies?**
werkzoeken.nl shows an exact date only for some vacancies ("7 november geplaatst"). For others it shows an update date ("Maandag bijgewerkt", in `updatedDate`) or a rough age ("3 weken geleden", in `postedAgo` and `postedDaysAgo`). The Actor returns exact dates only when the site gives them or the age is in hours or days.

**Why is the salary empty for some vacancies?**
Some employers don't publish a salary. werkzoeken.nl then shows "Salaris in overleg" (salary negotiable), which you get in `salaryText` with `salaryMin` and `salaryMax` set to `null`.

**How does the minimum salary filter work?**
It uses werkzoeken.nl's own salary filter, which matches vacancies whose salary range reaches your amount and also includes hourly wages that work out above it.

**How does incremental mode work?**
The first run saves every vacancy as `NEW` and builds a baseline. Later runs with the same search (or `stateKey`) return only `NEW`, `UPDATED`, and `REAPPEARED` vacancies. A vacancy whose search card has not changed is skipped without opening its detail page. Turn on **Include expired vacancies** to also get vacancies that left the search. Expiry is checked only when every search was scanned to its last page, so set **Max results** to `0` for reliable expiry detection.

**Can I schedule the scraper and connect it to other tools?**
Yes. Use [Apify schedules](https://docs.apify.com/platform/schedules) to run it daily or weekly, and send the results to Google Sheets, Slack, Make, Zapier, n8n, or your own system through [integrations](https://apify.com/integrations), webhooks, or the API.

**Something does not work or a field is missing.**
Open an issue on the **Issues** tab with your input and run ID, and we will look into it.

### Is it legal to scrape werkzoeken.nl?

The Actor collects only vacancy data that werkzoeken.nl shows openly to all visitors. Some vacancies name the person who receives applications, which is personal data under the GDPR. Make sure you have a lawful basis for storing and using it, and do not use it for unsolicited bulk messaging. For more background, read Apify's article [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) and consult a lawyer if you are unsure about your use case.

### Other job scrapers from ParseBird

| Actor | What it scrapes |
|-------|-----------------|
| [Werk.nl Jobs Scraper](https://apify.com/parsebird/werk-nl-jobs-scraper) | Vacatures from werk.nl, the UWV job site |
| [Jobbird Jobs Scraper](https://apify.com/parsebird/jobbird-jobs-scraper) | Dutch vacatures from Jobbird.com |
| [LinkedIn Jobs Scraper](https://apify.com/parsebird/linkedin-jobs-scraper) | LinkedIn job postings |
| [Glassdoor Scraper](https://apify.com/parsebird/glassdoor-scraper) | Glassdoor jobs, reviews, salaries, and company overviews |
| [Jobup.ch Scraper](https://apify.com/parsebird/jobup-ch-scraper) | Swiss job listings from Jobup.ch |
| [IrishJobs.ie Scraper](https://apify.com/parsebird/irishjobs-scraper) | Irish job listings from IrishJobs.ie |

# Changelog

This Actor's version history is a separate document: https://apify.com/parsebird/werkzoeken-nl-jobs-scraper/changelog.md

# Actor input Schema

## `queries` (type: `array`):

Job titles or keywords to search on werkzoeken.nl, one per line, for example 'kok', 'schilder' or 'software developer'. Each keyword runs as its own search. Leave empty with no start URLs to browse all vacancies.

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

Dutch cities, postcodes, regions or provinces, for example 'Amsterdam', '3511' or 'Noord-Brabant'. Each keyword is searched in each location. Leave empty to search all of the Netherlands.

## `radiusKm` (type: `integer`):

Search distance around each location. werkzoeken.nl offers 0, 10, 15, 30 and 50 km; other values also work. Only used when a location is set.

## `startUrls` (type: `array`):

werkzoeken.nl search result URLs (https://www.werkzoeken.nl/vacatures/?what=...), job pages (https://www.werkzoeken.nl/vacatures-voor/schilder/almere/) or vacancy URLs (https://www.werkzoeken.nl/vacature/16063249-voorman-schilder/). Filters in a search URL are applied strictly, so only matching vacancies are returned. Vacancy URLs always load full details.

## `maxResults` (type: `integer`):

Maximum number of vacancies to save across all searches. Set 0 for no limit.

## `includeDetails` (type: `boolean`):

Open each vacancy for the full description (text, HTML, Markdown), apply URL, address with coordinates, benefits, tasks, requirements, education, driver's license, contact person and employer info. Charged as a separate 'job-details' event. Turn off for search-card data only.

## `includeCompanyProfile` (type: `boolean`):

Add the employer's full werkzoeken.nl profile: industry, employee range, headquarters and branch addresses, average age, gender ratio, dress code, open vacancies per category and application steps. Needs full details. Each company is loaded once per run.

## `salaryMin` (type: `integer`):

Only vacancies whose salary range reaches at least this gross monthly amount (werkzoeken.nl's own salary filter, which also converts hourly wages). The site uses steps of €100 from €1,000 to €4,000, then €250 up to €7,500; other values are rounded down to the nearest step.

## `hoursMin` (type: `integer`):

Only vacancies with at least this many hours per week (0–40).

## `hoursMax` (type: `integer`):

Only vacancies with at most this many hours per week (0–40).

## `contractTypes` (type: `array`):

Contractvorm. Pick one or more; vacancies matching any of them are returned.

## `educationLevels` (type: `array`):

Opleiding required for the job.

## `experienceLevels` (type: `array`):

Ervaring asked for in the vacancy.

## `workSchedules` (type: `array`):

Werktijden: when the work takes place.

## `companyTypes` (type: `array`):

Soort bedrijf: who posted the vacancy.

## `companySizes` (type: `array`):

Bedrijfsgrootte by number of employees.

## `benefits` (type: `array`):

Voordelen the vacancy must offer.

## `noCvRequired` (type: `boolean`):

Return only vacancies marked 'CV niet verplicht', where you can apply without a CV.

## `publishedWithinDays` (type: `integer`):

Only keep vacancies posted at most this many days ago. werkzoeken.nl has no date filter, so the scraper checks each result's posting date; older ones are skipped and not charged. Ages shown as weeks ('2 weken geleden') count as the lower bound (14 days).

## `maxPagesPerSearch` (type: `integer`):

Stop each search after this many result pages (50 vacancies per page). 0 = no limit; Max results still applies. Useful with 'Published within', which skips results without stopping the search.

## `incrementalMode` (type: `boolean`):

Track vacancies across runs. The first run builds a baseline; later runs return only NEW, UPDATED and REAPPEARED vacancies, each with changeType, firstSeenAt and lastSeenAt.

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

Name for the saved tracking state. Runs with the same key compare against each other. Leave empty to derive one from the search input.

## `emitUnchanged` (type: `boolean`):

In incremental mode, also return vacancies that did not change (changeType UNCHANGED).

## `emitExpired` (type: `boolean`):

In incremental mode, also return tracked vacancies that are no longer listed (changeType EXPIRED). Only checked when every search ran to its last page.

## `skipReposts` (type: `boolean`):

In incremental mode, drop new vacancies that match an expired one by title, company, location, contract and description.

## `compact` (type: `boolean`):

Return only core fields (title, company, location, salary, hours, contract, education, dates, URLs, description). Smaller rows for AI agents and spreadsheets.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = full text.

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

werkzoeken.nl blocks datacenter IPs, so Apify residential proxies in the Netherlands are used by default. Proxy cost is included in the event prices.

## Actor input object example

```json
{
  "queries": [
    "schilder"
  ],
  "radiusKm": 30,
  "maxResults": 20,
  "includeDetails": true,
  "includeCompanyProfile": false,
  "noCvRequired": false,
  "maxPagesPerSearch": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "skipReposts": false,
  "compact": false,
  "descriptionMaxLength": 0,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}
```

# Actor output Schema

## `dataset` (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 = {
    "queries": [
        "schilder"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "NL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/werkzoeken-nl-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 = {
    "queries": ["schilder"],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "NL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("parsebird/werkzoeken-nl-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 '{
  "queries": [
    "schilder"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}' |
apify call parsebird/werkzoeken-nl-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/werkzoeken-nl-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/Eqk9j33f28ksRYsXs/builds/7WJeCpvxTrMUkVMJG/openapi.json
