StepStone Jobs Scraper

Scrape job listings from StepStone — Germany, Austria, UK, Netherlands and Belgium — by keyword and location. Clean, structured output, paginated.

StepStone sits behind anti-bot protection that blocks the obvious API and most datacenter IPs, which is why naive scrapers return empty or get captcha pages. This actor reads the rendered listings the way a browser sees them and rotates a fresh residential IP per page, with explicit handling for blocked pages instead of silently returning nothing.

Input

Field	Notes
keywords	Job title / keywords, e.g. software engineer, marketing manager.
location	Optional city/region, e.g. Berlin, Wien.
site	StepStone country site: DE / AT / UK / NL / BE.
maxItems	Jobs to collect; the scraper paginates to reach it.

Output

One row per job, each with ok: true:

Field	Notes
jobId	StepStone listing id. May be null if the URL has no id.
title	Job title.
company	Hiring company. May be null when StepStone hides it.
location	Job location. May be null.
salary	Only present when the listing publishes it — frequently null.
postedText	Human-readable posted date (e.g. "vor 3 Tagen"). May be null.
workFromHome	true/false remote flag.
snippet	Short description excerpt. May be null.
url	Job URL.
site	The StepStone country site searched.

Any of the text fields above can be null when StepStone omits them from the listing card.

Charging and failures

You are charged per successfully collected job (ok: true). The actor never charges for:

• No matches — returns a single ok: false NO_RESULTS diagnostic row, uncharged.
• A fully blocked search — if StepStone (DataDome) blocks every IP/browser rotation, returns an ok: false BLOCKED diagnostic row, uncharged.
• A partially blocked search — if a block hits mid-collection (e.g. on page 2), any rows already gathered are returned with ok: false and partial: true plus a BLOCKED diagnostic row, and none of them are charged. Retry — a different residential IP usually completes the search.

Notes

Use a RESIDENTIAL proxy in the target country (the actor defaults to it) — StepStone challenges datacenter IPs. The actor rotates a fresh residential IP and User-Agent on each block retry. Salary is only present when the listing publishes it.