Stepstone.de Jobs Scraper

Scrape job postings from stepstone.de — Germany's largest job board and the dominant recruiter platform for the DACH region (Germany / Austria / Switzerland).

Features

• Bulk search by keyword + city (or nationwide if location is empty)
• Returns title, company, location, salary (raw + min/max/currency/period), posted date, job URL, skills, sponsored / top-job flags
• Sort by relevance or by date (newest first)
• Optional: fetch full job description per listing
• Built for Apify residential proxy — handles Akamai Bot Manager edge defense
• Extracts data from the server-rendered __PRELOADED_STATE__ JSON (richer than DOM parsing, more stable across UI changes)

Input

{
  "searches": [
    { "keyword": "software engineer", "location": "berlin" },
    { "keyword": "data analyst",      "location": "munchen" }
  ],
  "maxPagesPerSearch": 4,
  "sortBy": "date",
  "fetchJobDetails": false,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  }
}

Field	Type	Default	Notes
searches	array	(required)	{keyword, location} pairs; location empty = nationwide
maxPagesPerSearch	int	4	25 jobs/page; max ~93 pages on Stepstone side
sortBy	enum	date	relevance or date
fetchJobDetails	bool	false	Adds full description via /listing/data/de/{id}
proxyConfig	object	residential DE	Required — datacenter IPs blocked by Akamai

Output

One row per job:

{
  "jobId": "11451237",
  "title": "Senior Software Engineer (m/w/d)",
  "jobUrl": "https://www.stepstone.de/stellenangebote--Senior-Software-Engineer-...inline.html",
  "companyId": "12345",
  "companyName": "Example GmbH",
  "companyUrl": "https://www.stepstone.de/cmp/de/example-gmbh-12345",
  "companyLogoUrl": "https://...",
  "datePosted": "2026-05-15T10:00:00+02:00",
  "location": "Berlin",
  "postCode": "10115",
  "salary": "65.000 € - 85.000 €",
  "salaryMin": 65000, "salaryMax": 85000,
  "salaryCurrency": "EUR", "salaryPeriod": "YEAR",
  "workFromHome": true,
  "textSnippet": "Wir suchen einen erfahrenen ...",
  "description": "Full description text...",
  "skills": ["Java", "Spring", "Docker"],
  "labels": ["Vollzeit"],
  "isSponsored": false,
  "isTopJob": false,
  "searchKeyword": "software engineer",
  "searchLocation": "berlin",
  "scrapedAt": "2026-05-18T12:00:00.000Z"
}

Use cases

• Recruiter intel: track competitor hiring (which roles, which cities, which salaries)
• ATS feed: auto-import new postings into your applicant tracking system
• Market research: salary benchmarking, role demand trends per region
• Job aggregators: rebuild a localized Stepstone clone with fresh data

Notes

• Akamai-protected: datacenter IPs are blocked at the edge. Residential proxy is mandatory; the default is correct for most use cases.
• TLS fingerprinting: uses got-scraping which mimics Chrome's TLS handshake (JA3/JA4). Don't replace with node-fetch or plain got — they'll get 403'd.
• Polite rate: 1–2 second jitter between pages, single concurrent request per session. Don't overdrive — Akamai will issue JS challenges and pages will start coming back empty.
• Pagination cap: Stepstone limits to ~93 pages per query (~2,300 jobs). For deeper coverage, split your search by city or sub-keyword.

---

Changelog

• 2026-05-20 — Maintenance pass: reviewed the input schema and default values for a smooth one-click start, and rebuilt the Actor on the latest base image.

Last reviewed: 2026-05-20.