Stepstone Jobs Scraper

Scrape job listings from Stepstone — the leading job board in Germany, Austria, Belgium, and the Netherlands. Filter by job title, location, radius, date posted, contract type, and minimum salary. Supports all four Stepstone country sites.

What does this Actor do?

This Actor uses a headless browser to navigate Stepstone's job search and extract job listings matching your criteria. It works in two stages:

1. Search stage — Queries Stepstone for each job title and extracts basic info from job cards using Stepstone's stable data-at attributes
2. Detail stage (optional) — Visits each job's full page to extract the complete description, job type, and industry

All results are pushed to the Apify Dataset, downloadable as JSON, CSV, or Excel.

---

Input

Field	Type	Default	Description
jobTitles	string[]	["Software Engineer"]	One or more job titles. Each runs as a separate search.
location	string	"Berlin"	City or region (e.g. "Hamburg", "Bavaria", "Vienna")
country	select	de	Stepstone site: Germany, Austria, Belgium, Netherlands
radius	integer	30	Search radius in km
datePosted	select	0	Any time / Today / Past 7 days / Past 30 days
contractType	select	""	All / Full-time / Part-time
minSalary	integer	0	Minimum annual salary in EUR (0 = all)
maxResultsPerSearch	integer	100	Max jobs per job title
fetchJobDetails	boolean	false	Visit each job page for full description, job type, industry
proxyConfiguration	proxy	Apify Residential	Recommended — Stepstone may block datacenter IPs

Example input

{
  "jobTitles": ["Data Scientist", "Machine Learning Engineer"],
  "location": "Munich",
  "country": "de",
  "radius": 30,
  "datePosted": 7,
  "contractType": "fulltime",
  "minSalary": 60000,
  "maxResultsPerSearch": 50,
  "fetchJobDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

Output

Each record in the Dataset represents one job listing. All fields are flat (no nested objects), compatible with CSV/Excel export.

Field	Description
jobId	Stepstone's internal job ID (extracted from URL)
searchQuery	Which job title query found this job
title	Job title
company	Company name
location	Job location
jobUrl	Direct link to the job posting
postedAt	Date or relative time the job was posted
salary	Salary range if provided
tags	Comma-separated tags/badges (e.g. "Vollzeit, Remote")
country	Which Stepstone site this job came from
jobType	e.g. "Vollzeit", "Teilzeit" (detail page only)
industry	Industry or department (detail page only)
descriptionLength	Character count of the description (detail page only)
description	Full job description text (detail page only)
scrapedAt	Timestamp when this record was scraped

Example output record

{
  "jobId": "987654321",
  "searchQuery": "Data Scientist",
  "title": "Data Scientist (m/w/d) - Machine Learning",
  "company": "Allianz SE",
  "location": "Munich",
  "jobUrl": "https://www.stepstone.de/stellenangebote/data-scientist-987654321.html",
  "postedAt": "Heute",
  "salary": "75.000 – 95.000 €",
  "tags": "Vollzeit, Hybrid",
  "country": "DE",
  "jobType": "Vollzeit",
  "industry": "Versicherungen",
  "descriptionLength": 3400,
  "description": "Wir suchen einen erfahrenen Data Scientist...",
  "scrapedAt": "2024-03-26T10:00:00.000Z"
}

---

Supported countries

Code	Site	Language
de	stepstone.de	German
at	stepstone.at	German (Austria)
be	stepstone.be	French/Dutch
nl	stepstone.nl	Dutch

---

Notes

• Stepstone uses stable data-at attributes for its job cards, making selectors much more resilient to design changes than class-based selectors.
• A headless browser (Playwright + Chrome) is required to render Stepstone's JavaScript-heavy pages. Memory requirement: 512 MB minimum.
• Page results are in the local language (German for .de/.at, Dutch/French for .be/.nl). Job titles should also be in the local language for best results (e.g., "Softwareentwickler" for German searches).

Disclaimer: This Actor is unofficial and not affiliated with, endorsed by, or supported by The Stepstone Group.