Stepstone Job Scraper 🔥

What does Stepstone Job Scraper do?

Stepstone Job Scraper collects public job listings from Stepstone.de and saves them as a structured Apify dataset. You can start with a Stepstone search or category URL, provide a keyword or category, and collect job titles, companies, locations, posting dates, employment types, salary information, and job descriptions.

The Actor is useful for recruitment research, hiring intelligence, salary analysis, competitor monitoring, job-market reporting, and career research. Results can be downloaded as JSON, CSV, Excel, or XML, or connected to another workflow through Apify integrations and API access.

Why use Stepstone Job Scraper?

• Build hiring datasets - Collect structured Stepstone job records without manually copying listings into a spreadsheet.
• Monitor job markets - Track roles, employers, locations, categories, and published salary information across recurring runs.
• Research hiring demand - Compare the types of roles companies advertise and the skills described in their listings.
• Capture job descriptions - Enable detailed collection to save both HTML and plain-text versions of available descriptions.
• Process multiple sources - Pass several public Stepstone search or category URLs in one run.
• Control run size - Set the maximum number of listings and result pages to match a test run or a larger dataset.
• Keep datasets clean - Leave deduplication enabled to avoid repeated job URLs when searches overlap.

What data can you extract from Stepstone.de?

Each detailed record represents one job listing. Some values can be empty when the employer or Stepstone does not publish them.

Field	Type	Description
title	String or null	Job position title.
company	String or null	Hiring company name.
location	String or null	Job location or region shown in the listing.
date_posted	String or null	Published date supplied by Stepstone.
job_type	String or null	Employment type, such as full-time or part-time.
job_category	String or null	Job category, industry, or occupational classification when available.
salary	String, Number, or null	Salary information when published.
url	String	Direct URL of the Stepstone job listing.
description_html	String or null	Clean HTML version of the job description when details are collected.
description_text	String or null	Plain-text version of the job description.

When collectDetails is set to false, the dataset contains URL records in this form:

{
  "url": "https://www.stepstone.de/stellenangebote--Software-Engineer--Berlin--123456-inline.html"
}

How to use Stepstone Job Scraper

1. Open the Actor in Apify Console.
2. Choose a public Stepstone search or category URL, or enter a keyword or category.
3. Set collectDetails, maxItems, maxPages, and dedupe according to the dataset you need.
4. Run the Actor and review the dataset preview.
5. Download the results or connect the dataset to your recruiting, research, or monitoring workflow.

If startUrls contains one or more URLs, those URLs are used first. Otherwise, the Actor uses startUrl, then a URL built from keyword, then a URL built from category.

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	None	One public Stepstone search or category URL. Used when startUrls is empty or not provided.
startUrls	Array of strings	No	None	Multiple public Stepstone search or category URLs to process in one run. A non-empty array takes priority over startUrl.
keyword	String	No	Empty	Job search phrase, such as software engineer or marketing manager. Used when no starting URL is supplied.
category	String	No	verwaltung	Stepstone job category path, such as it, engineering, or verwaltung. Used when no URL or keyword is supplied.
collectDetails	Boolean	No	true	Collect detailed job records and descriptions when true. When false, save discovered job URLs only.
maxItems	Number	No	100	Maximum number of job listings to save. Use a positive value; 0 stops collection immediately.
maxPages	Number	No	20	Maximum number of Stepstone result pages to process.
dedupe	Boolean	No	true	Skip duplicate job URLs when true.
proxyConfiguration	Object	No	None	Optional Apify proxy settings for runs that need proxy routing.

The location and datePosted values shown in older versions of this README are not active inputs in the current Actor behavior. To use a location or date filter, create the filtered search on Stepstone and pass its public URL through startUrl or startUrls.

Output Data

With collectDetails: true, each dataset item uses the following fields:

Field	Type	Description
title	String or null	Job title.
company	String or null	Employer name.
location	String or null	Published job location.
date_posted	String or null	Job publication date when available.
job_type	String or null	Employment type when available.
job_category	String or null	Category or industry information when available.
salary	String, Number, or null	Salary information when available.
url	String	Direct Stepstone job URL.
description_html	String or null	HTML job description when available.
description_text	String or null	Plain-text job description when available.

With collectDetails: false, each item contains only the discovered url field.

Usage Examples

Basic Category Search

Collect up to 50 detailed listings from Stepstone's IT category:

{
  "category": "it",
  "collectDetails": true,
  "maxItems": 50
}

Keyword-Based Search

Search for data-science roles and collect the first 100 available listings:

{
  "keyword": "data scientist",
  "maxItems": 100,
  "maxPages": 20,
  "dedupe": true
}

Multiple Prepared Search URLs

Process two public Stepstone searches in one run and save URLs without fetching detailed records:

{
  "startUrls": [
    "https://www.stepstone.de/jobs/it",
    "https://www.stepstone.de/jobs/engineering"
  ],
  "collectDetails": false,
  "maxItems": 200,
  "maxPages": 10
}

Prepared Search with Proxy Routing

Reuse a Stepstone search URL and route the run through Apify Proxy when needed for a larger or recurring collection:

{
  "startUrl": "https://www.stepstone.de/jobs/software-engineer",
  "collectDetails": true,
  "maxItems": 100,
  "maxPages": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Sample Output

This example shows one detailed dataset item. Empty source fields may be returned as null.

{
  "title": "Software Engineer (m/w/d)",
  "company": "Example Technology GmbH",
  "location": "Berlin",
  "date_posted": "2026-08-04",
  "job_type": "Full-time",
  "job_category": "Engineering",
  "salary": "65,000 - 80,000 EUR",
  "url": "https://www.stepstone.de/stellenangebote--Software-Engineer--Berlin--123456-inline.html",
  "description_html": "<div><p>We are looking for a software engineer to join our product team.</p><ul><li>Build and maintain web applications.</li></ul></div>",
  "description_text": "We are looking for a software engineer to join our product team. Build and maintain web applications."
}

Tips for Best Results

• Start with a small limit - Test a category or search with 20-50 items before increasing maxItems.
• Use specific search terms - Phrases such as data engineer, accountant, or project manager usually produce more focused datasets than broad terms.
• Use prepared URLs for filters - Apply location, date, or other supported Stepstone filters on the website, then pass the resulting public URL as startUrl or an item in startUrls.
• Increase pages for larger datasets - Raise maxPages when the first result pages do not contain enough listings.
• Keep deduplication enabled - This is helpful when multiple URLs contain overlapping search results.
• Test detail collection first - Use collectDetails: true when you need descriptions and metadata; use false when a URL list is sufficient.
• Review missing fields carefully - Missing salary, category, or description values usually mean that the source listing did not publish that information.
• Schedule consistent searches - Reuse the same URLs and limits in scheduled runs when comparing hiring activity over time.

Integrations

• Google Sheets - Review job records, compare employers, and share hiring reports.
• Airtable - Build a searchable job database for recruiting or market research.
• Webhooks - Send completed run events to a downstream application.
• Make or Zapier - Trigger notifications, enrichment, or task creation from new datasets.
• API - Read dataset items programmatically from your own systems.

Export Formats

Apify datasets can be downloaded in formats suited to different workflows:

Format	Useful for
JSON	APIs, applications, and data pipelines
CSV	Spreadsheet analysis and filtering
Excel	Business reports and review by recruiting teams
XML	Systems that require XML input

Frequently Asked Questions

Can I collect jobs from more than one Stepstone search?

Yes. Add multiple public search or category URLs to startUrls. The Actor processes every URL in the non-empty array before using any fallback input.

Can I search by keyword without a URL?

Yes. Enter a value in keyword, such as software engineer, and the Actor builds a Stepstone jobs URL from it.

How can I filter by location or posting date?

Create the filtered search on Stepstone and provide its public URL through startUrl or startUrls. The current Actor does not apply separate location or datePosted input fields.

Can I collect only job URLs?

Yes. Set collectDetails to false. The dataset will contain one url field for each discovered listing.

Why are some job fields empty?

Some employers do not publish salary, category, employment type, location, or a full description. The Actor saves the available source data and returns unavailable detailed values as null.

Can I export Stepstone data to CSV or Excel?

Yes. Apify datasets support JSON, CSV, Excel, XML, and other export formats available in Apify Console.

Can I schedule recurring Stepstone job searches?

Yes. Create an Apify schedule to run the Actor hourly, daily, weekly, or at another interval supported by your workflow.

Is collecting public Stepstone data legal?

Public-data collection may be subject to website terms, copyright, privacy rules, and local laws. You are responsible for using the Actor lawfully, respecting Stepstone's terms and access restrictions, and handling job data responsibly.

Related Actors

• APEC Jobs Scraper - Collect French executive and professional job listings.
• BuiltIn Jobs Scraper - Collect technology job listings and hiring details from BuiltIn.
• Foundit Jobs Scraper - Collect job postings from Foundit, formerly Monster.
• Talent Job Scraper - Collect structured job postings for research, lead generation, and monitoring.

Support

For issues or feature requests, use the Issues tab on the Actor page or contact the developer through Apify.

Legal Notice

This Actor is designed for legitimate collection of publicly available job information. Users are responsible for complying with applicable laws, Stepstone terms, privacy requirements, and any restrictions that apply to the data they collect or reuse.