Skip to main content
Scrape StepStone job listings

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

keyword
string | null

Job title, skill or company, e.g. 'python developer' or 'Pflegefachkraft'.

location
string | null

City or region, e.g. 'Berlin' or 'München'. Leave empty to search the whole country.

country
string
default:de

StepStone site: de, at, be (stepstone.de, stepstone.at, stepstone.be).

radius
integer | null

Distance around location in km: 5, 10, 20, 30, 40, 50, 75, 100.

days
integer | null

Posting age: 1 or 7 (last 24 hours or last 7 days).

remote
string | null

partial (home office possible) or full (home office only).

employment
string | null

full_time or part_time.

experience
string | null

Comma list of: none, experienced, manager (no experience, with experience, with staff responsibility).

contract_type
string | null

Comma list of: permanent, temporary, temp_agency, trainee, freelance, apprenticeship, thesis, internship, working_student, phd, sales_agent (stepstone.de / .at), or StepStone's numeric contract-type ids.

min_salary
integer | null

Minimum yearly salary, 10000-100000 in steps of 10000.

language
string | null

Language the ad is written in, comma list of two-letter codes, e.g. 'en'.

apply_method
string | null

Comma list of: company_site, quick_apply (apply on the company's site or with StepStone's quick apply).

sort
string
default:relevance

relevance or date (newest first).

search_url
string | null

A StepStone results page URL to collect instead of keyword/location and filters, e.g. 'https://www.stepstone.de/jobs/data-analyst/in-berlin?radius=30'.

page
integer
default:1

1-based results page to start from; nextPage continues.

Required range: x >= 1
max_results
integer
default:25

Jobs to collect, 1-500. Each results page (25 jobs) is billed one unit.

details
boolean
default:false

Add each job's page: full description by section, contract and work type, address with coordinates, company size. Up to 50 jobs; one more unit per job page fetched.

proxy_country
string | null

Proxy country the requests are sent from (ISO-2, e.g. 'DE'). Leave blank to let the API pick.

Response

JSON with a jobs array plus totals.