stepstone.com APIstepstone.com ↗
Search and extract job listings from Stepstone.de. Get job details, salary estimates, company info, and similar jobs via 4 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/7da251f1-0c14-4eac-b1a2-9dffa8d0e080/search_jobs?keyword=developer&location=Berlin' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job listings on Stepstone.de by keyword and optional location. Returns paginated results including job summaries, filters, and pagination metadata. Supports filtering by application method, date posted, language, remote work, and sorting.
| Param | Type | Description |
|---|---|---|
| am | string | Application method filter: 'EXTERNAL' for company website, 'INTERNAL' for Easy Apply. |
| age | string | Date posted filter: 'age_1' for last 24 hours, 'age_7' for last 7 days. |
| fdl | string | Job language filter: 'de' for German, 'en' for English. |
| wfh | integer | Work from home filter: 1 for Fully remote, 2 for Partially remote. |
| page | integer | Page number for pagination. |
| sort | integer | Sorting order: 1 for Relevance, 2 for Date. |
| keywordrequired | string | Job title or keyword to search for (e.g. 'software engineer', 'developer'). |
| location | string | Location to search in (city, region, or postcode). Omitting returns results for all of Germany. |
{
"type": "object",
"fields": {
"searchResults": "object containing items (array of job summaries), filters, pagination, sorting, and meta information"
},
"sample": {
"data": {
"searchResults": {
"items": [
{
"id": 13931558,
"url": "/jobs--Holographic-Display-Product-Developer-m-f-x-Jena-ZEISS--13931558-inline.html?rltr=1_1_25_seorl_m_0_0_0_0_0_0",
"title": "Holographic Display Product Developer (m/f/x)",
"location": "Jena",
"datePosted": "2026-05-06T10:20:07+02:00",
"companyName": "ZEISS",
"workFromHome": "2"
}
],
"pagination": {
"page": 1,
"perPage": 25,
"pageCount": 145,
"totalCount": 3617
}
}
},
"status": "success"
}
}About the stepstone.com API
The Stepstone.de API gives developers access to job listing data from one of Germany's largest job boards across 4 endpoints. Use search_jobs to query by keyword and location with filters for remote work, posting date, and language, then fetch full listing details — including salary ranges, company profiles, and schema.org JobPosting fields — via get_job_detail. Results cover titles, employment types, hiring organizations, and predicted salary data in structured JSON.
Search and Filter Jobs
The search_jobs endpoint accepts a required keyword parameter and an optional location (city, region, or postcode). Omitting location returns results across all of Germany. Additional filters include wfh (1 for fully remote, 2 for partially remote), am for application method (EXTERNAL for company-site apply, INTERNAL for Easy Apply), age for recency (age_1 for last 24 hours, age_7 for last 7 days), and fdl for job language (de or en). The response object includes an items array of job summaries, pagination metadata, available filters, and sort options.
Job Details and Salary Data
get_job_detail takes a relative job URL path and returns a detailed payload: listingHeader with core job metadata, textSections with the full job description, locationWithCommuteTime, companyCard and companyPassport with employer details, and a reduxPreloadedState block. The endpoint also returns job_posting_schema — a schema.org JobPosting object with title, datePosted, employmentType, hiringOrganization, and jobLocation fields suitable for direct integration with structured-data pipelines.
get_salary_info returns the same payload shape but is specifically useful for accessing listingHeader.CESalary (with min, max, period, and currencyIso fields) and reduxPreloadedState.predictedSalary. Not every listing carries a populated salary field — availability depends on the individual posting.
Similar Jobs
get_similar_jobs fetches the full job detail payload for a given listing. When the source includes similar job recommendations for that listing, they appear within the response alongside the standard listingHeader, textSections, companyCard, and companyPassportData fields. Availability of similar job data varies by listing.
- Aggregate German job market data by keyword and location using
search_jobspagination to build sector-level trend reports. - Extract structured salary ranges from
listingHeader.CESalaryto compare compensation across roles, companies, or cities. - Feed schema.org
JobPostingdata fromget_job_detaildirectly into a job aggregator or SEO-optimized listings page. - Filter listings by
wfh=1to build a dedicated remote-only job board focused on the German market. - Monitor newly posted jobs using the
age_1date filter to surface listings from the past 24 hours for real-time alerts. - Pull
companyCardandcompanyPassportfields to enrich a company database with employer profiles from active job postings. - Use
get_similar_jobsrecommendations to build a job recommendation engine seeded from a known listing.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Stepstone have an official developer API?+
What does `search_jobs` return, and how does pagination work?+
searchResults object containing an items array of job summaries, a filters block listing available facet options, pagination metadata (current page, total pages, total results), and sorting information. Use the page integer parameter to step through result pages. The sort parameter accepts 1 for relevance or 2 for date.Is salary data available for every job listing?+
get_salary_info endpoint returns listingHeader.CESalary (with min, max, period, and currencyIso) and reduxPreloadedState.predictedSalary when that data exists in the listing. Many listings do not include a posted or predicted salary, so these fields may be null or absent depending on the individual posting.Does the API cover Stepstone sites outside Germany, such as stepstone.be or stepstone.co.uk?+
Can I retrieve a list of all companies currently hiring, or browse by company profile?+
companyCard and companyPassport fields in get_job_detail, but there is no dedicated endpoint for browsing or listing company profiles independently of a job search. You can fork the API on Parse and revise it to add a company-focused endpoint.