# 🇪🇺 StepStone NL BE AT & Totaljobs | EU Jobs (`antique_sundew/stepstone-nl-scraper`) Actor

Scrape job listings from StepStone Netherlands, Belgium, Austria, and Totaljobs UK. Multi-market European recruitment and salary scraper API.

- **URL**: https://apify.com/antique\_sundew/stepstone-nl-scraper.md
- **Developed by:** [Alexandru Afanasiuc](https://apify.com/antique_sundew) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 job scrapeds

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## StepStone Netherlands, Belgium, Austria & Totaljobs UK Scraper

Extract job listings from **four job markets with one Actor**: [stepstone.nl](https://www.stepstone.nl) (Netherlands), [stepstone.be](https://www.stepstone.be) (Belgium), [stepstone.at](https://www.stepstone.at) (Austria) and [totaljobs.com](https://www.totaljobs.com) (UK). Pick the market with a single `country` input and get clean JSON/CSV with titles, companies, locations, posting dates and work-from-home flags.

### Why use this scraper

- **Four markets, one input schema** — switch `country` between `nl`, `be`, `at` and `uk`; everything else stays the same. Ideal for cross-border hiring research.
- **Triple-verified location filter** — a location the board does not recognise returns **zero rows**, never the national feed. The guard checks the response against the national feed *and* against the rows themselves, on every market.
- **Work-from-home flags** — remote/hybrid tags are extracted whenever the board publishes them.
- **Deduplicated** — the same listing never appears twice in one run.
- **Pure HTTP** — no browser; a 100-job run typically finishes in well under a minute.

### What data you get

```json
{
  "id": "12345678",
  "title": "Verpleegkundige",
  "url": "https://www.stepstone.nl/vacatures--Verpleegkundige-Amsterdam/12345678",
  "textSnippet": "Wij zoeken een verpleegkundige voor ons team in Amsterdam...",
  "company": {
    "name": "Example Zorggroep",
    "logoUrl": "https://www.stepstone.nl/upload_nl/logo/example.gif",
    "url": "https://www.stepstone.nl/cmp/nl/example-zorggroep"
  },
  "location": "Amsterdam",
  "datePosted": "2026-08-05",
  "workFromHome": "PARTIALLY_HOME",
  "isAnonymous": false,
  "country": "nl",
  "scrapedAt": "2026-08-11T10:00:00.000Z"
}
```

Fields the posting does not include are `null` — this Actor never invents data. Salary and contract details are not part of the listing feed on these boards, so they are not claimed and not billed.

### How to run it

1. Pick your market: `country` = `nl`, `be`, `at` or `uk`.
2. Set `keywords` (e.g. `["developer"]`, `["verpleegkundige"]`, `["accountant"]`).
3. Optionally add a `location` (e.g. `"Amsterdam"`, `"Wien"`, `"Manchester"`).
4. Click **Start** and export the dataset as JSON, CSV or Excel.

Works out of the box: the default input (`keywords: ["developer"]`, `country: "nl"`, `maxItems: 100`) runs successfully with no changes.

### Input parameters

| Field | Type | Default | Description |
|---|---|---|---|
| `keywords` | array | `["developer"]` | Search terms. |
| `country` | string | `"nl"` | Market: `nl`, `be`, `at`, `uk` (Totaljobs). |
| `location` | string | — | City or region on the chosen market. |
| `maxItems` | integer | `100` | Cap on returned jobs. |

### Pricing

**$3.00 per 1,000 jobs** (pay per event, no subscription). Examples:

- 100 jobs → **$0.30**
- 500 jobs → **$1.50**
- Zero results (unrecognised keyword or location) → **$0.00** — empty runs are never charged.

### Use cases

- **Cross-market hiring research** — run the same keyword across NL, BE, AT and UK and compare volume per market.
- **Job alerts** — schedule daily runs per market and push new rows to Sheets, Slack or email.
- **Remote-work tracking** — filter on `workFromHome` to measure how much of a market hires remote.
- **Recruitment lead generation** — `company.url` links straight to the employer's profile page.
- **AI agents** — call this Actor as a tool through the [Apify MCP server](https://mcp.apify.com/?actors=antique_sundew/stepstone-nl-scraper).

### Limitations

- Returns what the listing feed publishes: title, company, location, date, snippet, remote flag. Salary and contract type are not in these boards' feeds.
- One `country` per run — loop over markets with four runs (or a Schedule) for full coverage.
- Anonymous postings carry `isAnonymous: true` and no company name, exactly as the board shows them.

### FAQ

**How do I scrape StepStone Netherlands without coding?**
Run this Actor from the Apify Console — pick `nl`, set keywords, press Start, export CSV.

**Does it cover Germany?**
No — Germany has its own Actor: [StepStone.de Scraper](https://apify.com/antique_sundew/stepstone-scraper). This one covers NL, BE, AT and Totaljobs UK.

**What happens on a typo'd location?**
Zero rows, zero cost, on every market. The filter is verified three ways against the national-feed fallback.

**Can I run all four markets at once?**
One market per run keeps billing predictable — schedule four runs or call it four times from the API.

### Related Actors

- [StepStone.de Scraper](https://apify.com/antique_sundew/stepstone-scraper) — the German market
- [Reed.co.uk Jobs Scraper](https://apify.com/antique_sundew/reed-uk-jobs-scraper) — UK's Reed job board
- [Pracuj.pl Scraper](https://apify.com/antique_sundew/pracuj-scraper) — Poland's largest job board
- [eJobs.ro Scraper](https://apify.com/antique_sundew/ejobs-scraper) — Romania's largest job board

***

If this Actor saved you time, a short review on its Store page helps other people find it. If something looks wrong, open an issue on the **Issues** tab — issues get answered.

# Actor input Schema

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

Keywords or search terms (e.g. \['developer', 'engineer']).

## `location` (type: `string`):

City name. Unknown places return zero rows. Location is a radius search — nearby towns may appear (e.g. Amsterdam results can include Den Haag).

## `country` (type: `string`):

StepStone Group market. Germany stays on antique\_sundew/stepstone-scraper. uk and totaljobs are the same board (totaljobs.com).

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

Maximum job listings to return across the whole run.

## Actor input object example

```json
{
  "keywords": [
    "developer"
  ],
  "country": "nl",
  "maxItems": 100
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("antique_sundew/stepstone-nl-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("antique_sundew/stepstone-nl-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 '{}' |
apify call antique_sundew/stepstone-nl-scraper --silent --output-dataset

```

## MCP server setup

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