StepStone Jobs Scraper API — 18 Portals, Salaries & Contacts
Pricing
from $0.55 / 1,000 stepstone job results
StepStone Jobs Scraper API — 18 Portals, Salaries & Contacts
Collect jobs across 18 StepStone Group portals, including Germany, Austria, Belgium, Netherlands, UK, Ireland and South Africa. Salary estimates with provenance, full advert sections, public recruiter contacts, employer profiles and new/updated-job feeds.
Pricing
from $0.55 / 1,000 stepstone job results
Rating
0.0
(0)
Developer
Kelopr_bk
Maintained by CommunityActor stats
0
Bookmarked
14
Total users
2
Monthly active users
23 days ago
Last modified
Categories
Features
Share
StepStone Jobs Scraper API — 18 Portals, Salaries & Contacts 💼
Collect job listings from StepStone and its sister portals, then turn them into useful recruiting, salary and employer data. Search by role and location, paste a filtered search link, or supply exact job URLs.
Each saved vacancy is one result. Optional details add the full advert, separate responsibilities and requirements, salary provenance, public recruiter contacts, workplace information and employer data. Ready jobs appear in Results while the collection is still running.
Export JSON, CSV or Excel, or consume the dataset through the Apify API. No StepStone account is required.
🚀 Start with a small sample
{"mode": "SEARCH","keywords": ["data analyst"],"locations": ["Berlin"],"country": "DE","maxItems": 5,"includeDetails": true}
Use a few jobs to check coverage before requesting a larger collection. Optional fields vary by employer, portal and advert.
🌍 Supported portals
Input country | Portal | Main market |
|---|---|---|
DE | stepstone.de | Germany |
AT | stepstone.at | Austria |
BE | stepstone.be | Belgium |
NL | stepstone.nl | Netherlands |
TOTALJOBS | totaljobs.com | United Kingdom |
CWJOBS | cwjobs.co.uk | UK technology jobs |
JOBSITE | jobsite.co.uk | United Kingdom |
MILKROUND | milkround.com | UK graduate jobs |
CATERER | caterer.com | Hospitality |
RETAILCHOICE | retailchoice.com | Retail |
CATERERGLOBAL | catererglobal.com | International hospitality |
CAREERSTRUCTURE | careerstructure.com | Construction and engineering |
CITYJOBS | cityjobs.com | Financial services |
JUSTENGINEERS | justengineers.net | Engineering |
EMEDCAREERS | emedcareers.com | Healthcare and life sciences |
NIJOBS | nijobs.com | Northern Ireland |
JOBSIE | jobs.ie | Ireland |
PNET | pnet.co.za | South Africa |
The chosen portal controls generated keyword searches. A pasted URL keeps its original portal. Some UK brands link to the same vacancy on Totaljobs; the Actor follows the public job link and deduplicates its identity. A portal's main market does not imply every advertised workplace is in that country.
🧭 Choose your input mode
| Mode | What to provide | What it collects |
|---|---|---|
AUTO | Keywords, URLs, or both | Combines the supplied input types |
SEARCH | keywords, optional locations | A search for each keyword/location combination; supplied URLs also remain supported |
URLS | startUrls | Search pages and direct job pages |
DETAILS | Direct job URLs | Those exact vacancies, with full available page data |
keyword and location remain supported for older tasks. Put each separate role in its own keywords entry. A comma inside one entry is searched literally and generates a warning.
📦 What you receive
Core job information
id, jobKey, harmonisedId, title, companyName, companyId, companyUrl, companyLogoUrl, location, postCode, country, portal, datePosted, publishFromDate, publishToDate, jobUrl, sourceUrl, searchKeyword, searchLocation and scrapedAt identify the vacancy and how it was collected. countrySource distinguishes a source workplace country from a portal-market fallback; portalMarketCountry preserves the portal's market separately.
Source flags include sponsored and highlighted status, source match type, labels, benefits and available skills. Values are retained when the source provides a real zero or false.
💰 Salary figures with a source
| Field | Meaning |
|---|---|
salary, salaryText | Readable salary and original text where provided |
salaryMin, salaryMax | Numeric source range |
salaryCurrency, salaryPeriod | Currency code and pay period |
salarySource | For example stepstone_estimate, job_posting, job_page or description |
salaryIsEstimate | Whether the source identifies the figure as an estimate |
salaryYearlyMin, salaryYearlyMax | Annual figures when a supported comparison is possible |
salaryAnnualizationBasis | The source or calculation behind annual figures |
StepStone predictions are clearly distinguished from stated pay. Predictions are not salary promises from the employer. An hourly figure is not silently turned into annual income.
When a stated figure in the advert and a StepStone prediction both exist, the stated pay is preferred over the prediction. salaryInAdvertText and stepstoneSalaryEstimate retain the available alternatives and their sources. An “ab/from” minimum does not invent an upper salary bound.
Yearly source values stay yearly. Monthly pay is shown as ×12 for comparison and explicitly labelled monthly_x12_excludes_extra_payments; additional Austrian salary payments, bonuses and allowances are not assumed. Original monthly values remain available. Currency conversion is not performed.
For some German vacancies, the public search or job-page data contains an estimate even when the visible card says “Gehalt anzeigen”. It is collected only when numeric source values actually exist. Missing pay remains unavailable.
📄 Full advert and application information
Enable includeDetails for descriptionText, descriptionHtml, introductionText, responsibilities, requirements, benefitsText, applicationInformation and the source's named descriptionSections when available.
Additional page fields include employmentType, workSchedules, contractType, workType, listingLanguage, validThrough, directApply, easyApply, noCoverLetter and applyUrl.
applyUrlType: "source_link" identifies an explicit application link. applyUrlType: "job_page" means the vacancy page is the available application entry point. A fallback job-page link is never presented as a recovered external ATS address.
Application-method filters use an explicit quick-apply signal or the source's selected search facet. A direct URL without a known application method cannot satisfy that filter; directApply alone is not reinterpreted as an internal/external channel.
Set includeDescriptionHtml: false to keep the text without its HTML representations.
outputMode: "full" keeps additional native list fields and the public jobPosting object on detail pages where it exists. rawOutput: true also retains the original search job object as _raw. Use clean=false when requesting raw underscore-prefixed fields through the dataset API; standard clean exports hide those fields.
🏠 Workplace and remote status
workModel, remoteFriendly and workModelEvidence explain the source's remote signal. hybrid and remote remain distinct. If an advert merely says home office is possible, remote_or_hybrid preserves that uncertainty.
Available location data includes jobLocations, streetAddress, city, region, postCode, workplaceAddress, latitude and longitude. Exact map coordinates are returned only when provided by the source.
🏢 Employer data
Job pages can already expose companyEmployees, companyJobsCount, companyIndustries, companyBenefits, companyWebsite, companyAddress, companyFounded, companyRating and companyReviewsCount.
includeCompany additionally requests each employer profile once per run. Existing job-page information is retained if a separate company page is unavailable. companyEnrichmentStatus describes that lookup. Company headcount, vacancy totals, founding year and ratings are never fabricated.
📇 Public recruiter contacts
Enable includeContacts to read job pages and populate emails, phones, recruiterNames, contactEvidence and the backward-compatible contacts object.
Contacts come from the advert and its application information. Unrelated navigation and footer contacts are excluded. A missing email is not guessed from a person's name. Many employers accept applications only through the vacancy page and publish no direct contact.
Advertised web and social links are exposed as advertisedUrls and socialProfileUrls when present in the collected advert.
🛠️ Skills
skills retains the portal's source data. mentionedSkills separately identifies supported tool and skill names that occur literally in the collected advert text. skillsSource makes that distinction visible. Mentioned skills are not inferred from a job title or generated by an AI model.
🎯 Filters and search options
| Input | Scope and behaviour |
|---|---|
locations | Every keyword is searched in each location |
radiusKm | Radius for generated location searches |
sortBy | relevance or date for generated searches |
postedWithin | all, 1d, 3d, 7d, 14d, 30d; source timestamps are also checked |
onlyNewerThan | Exclusive publication cutoff; ISO date, Unix seconds or milliseconds |
matchTypes | Source exact, similar, nearby, recommended or unknown classification |
excludeRecommended | Removes source-recommended padding; enabled by default |
excludeSponsored | Removes explicitly sponsored jobs |
remoteOnly | Requires a source home-office/remote signal, including hybrid |
workModels | Requires one of the selected source-confirmed models |
employmentTypes | Matches available source working schedules |
contractTypes | Matches exact source contract labels, such as Feste Anstellung or Permanent |
listingLanguages | Native detected-language category for generated searches |
adLanguages | Strictly require the advert's declared language, reading job pages when necessary |
applicationMethods | Native INTERNAL quick-apply or EXTERNAL employer-site search filter |
titleInclude, titleExclude | Case-insensitive title phrases |
companyInclude, companyExclude | Case-insensitive employer-name phrases |
skipJobIds | Skip known IDs without using result slots |
salaryOnly | Requires numeric salary data |
includeSalaryEstimates | Keep or remove source-labelled predictions |
minYearlySalary, maxYearlySalary | Compare the lower/upper annual bound respectively |
salaryCurrencies | Restrict comparisons to specified source currency codes |
A search language category can include an advert whose author declared another language. searchLanguageFilters records the native search selection; listingLanguage comes from the advert's own data. Use adLanguages for a strict declared-language requirement; this can inspect many ads, so test with a small page cap first. The interface language is not used as the advert language.
Source match type means StepStone's classification of the result. It does not mean the title exactly equals your keyword. Use title phrase filters when the title wording matters. Direct job pages have no search-result section classification.
Salary, workplace and employment filters can require a job page when list data is insufficient. A job removed after that lookup receives no job-result event, although the lookup still consumes platform resources. Filtering is performed before the job is saved and billed.
For advanced native facets, use sourceContractIds, sourceExperienceIds, sourceIndustryIds, sourceSkillIds or sourceRegionIds with IDs from the selected portal's current search URL. IDs differ by portal. Pasted search URLs can retain all the filters supplied by the website, including ones not represented by separate form fields. Generated-search settings do not silently replace a pasted URL's own sort order or facets.
🔢 Limits, pagination and duplicates
maxItems is a global saved-job limit across the run. Filtered, duplicate, unchanged and empty candidates do not consume it. A first page containing mostly rejected jobs does not prevent later matching vacancies from filling the allowance.
maxPagesPerSearch is the maximum number of pages fetched for each search. If a pasted URL starts at page 3, a two-page allowance reads pages 3 and 4. The Actor follows real continuation and stops at source exhaustion, a repeated continuation URL, the requested page cap, the result cap or the customer's event-charge limit.
Set maxItems: 0 to continue within the page and source limits, with a maximum of 100,000 saved jobs. A page cap is reported as max_pages, not as proof that all source jobs were collected.
The same vacancy found by several searches or supplied again as a direct URL is saved once. Jobs with different source IDs remain distinct; identical titles alone do not prove that they are the same opening.
🔄 New and updated jobs
{"keywords": ["data analyst"],"locations": ["Berlin"],"country": "DE","includeDetails": true,"incrementalMode": "new_and_updated","stateKey": "berlin-analyst-feed","maxItems": 100}
off: return every matching job in this run.new_only: return IDs not previously delivered to this feed.new_and_updated: return new IDs and jobs whose collected content has changed.
changeStatus, contentHash, firstSeenAt and previouslySavedAt explain repeat-run output where applicable. Search URLs and scrape timestamps do not themselves cause an update.
State is isolated by Actor, authenticated user and stateKey. Use separate keys for independent feeds. Only jobs successfully delivered update the state. A change in requested enrichment can also change the collected content. Concurrent runs sharing a feed key can overlap; serialize a feed's runs when strict repeat-run deduplication matters.
The Actor does not declare unseen jobs expired merely because a limited search stopped before reaching them. No schedules or messages are created automatically. Use Apify's normal schedules and integrations if you choose to automate a feed.
📊 Employer hiring summaries
Enable includeHiringInsights for a separate Hiring summary dataset. Each employer row includes collected roles and locations, public contacts, remote-friendly job counts and available annual salary bands.
Currency and estimate status remain separate in salary bands. jobsCollected describes this collection; companyJobsCount is the employer's source-provided total when available. The two counts are not interchangeable.
collectionComplete and collectionStopReason identify a limited sample. A collection capped at 50 jobs is not presented as an exhaustive employer or market survey. These derived rows do not create extra job-result events.
🧪 Useful recipes
Recruiter contacts and employer profiles
{"keywords": ["SAP consultant"],"country": "AT","locations": ["Wien"],"includeDetails": true,"includeContacts": true,"includeCompany": true,"maxItems": 25}
Germany: annual salary range
{"keywords": ["data analyst"],"country": "DE","includeDetails": true,"salaryOnly": true,"salaryCurrencies": ["EUR"],"minYearlySalary": 60000,"maxItems": 50}
The minimum compares the lower salary bound. A €52,000–€75,000 range does not satisfy a €60,000 lower-bound threshold.
UK technology jobs
{"keywords": ["software engineer"],"country": "CWJOBS","locations": ["London"],"includeDetails": true,"maxItems": 25}
Continue from a search page
{"mode": "URLS","startUrls": [{"url": "https://www.stepstone.de/jobs/data-analyst/in-berlin?page=2"}],"maxPagesPerSearch": 2,"maxItems": 50,"includeDetails": true}
Read exact jobs
Choose DETAILS and paste current public job URLs into startUrls. Those jobs receive the same result filters and global deduplication as search results. Invalid or unsupported URLs are explained before source collection begins.
✅ Results and diagnostics
The Output tab separates Results, Salaries, Advert sections, Contacts, Employers, Skills, Changes, Hiring summary, Errors and Run summary.
OUTPUT records saved counts, source requests, per-search pages, discovered and examined candidates, filtered rows, duplicates, unchanged jobs, failures, continuation and stop reasons. PROGRESS exposes counts while the Actor is active.
Per-row dataCoverage, detailStatus, detailError and companyEnrichmentStatus distinguish unavailable optional data from successful enrichment. Empty optional fields do not turn a real job into an empty result. Identity-only shells and unusable detail pages are not sold as successful vacancies.
onlyNewerThan is exclusive and uses publication time. A valid recent cutoff can legitimately produce no new jobs. If older jobs were found but all were rejected, the summary explains no_new_items_since_cutoff and how to change the cutoff. A missing timestamp is not guessed from a scrape date.
Ready rows stay in the dataset if a run is cancelled. Graceful cancellation lets an in-progress save finish and closes the remaining work. An immediate hard stop can interrupt final summaries. Disconnecting from the asynchronous API is not a cancellation request; check the run status or use Apify's abort action.
💳 Pricing and resource use
The currently configured result price is $0.55 per 1,000 saved jobs, plus $0.00005 per run-start event. Platform usage is billed separately under this Actor's current pricing configuration. Check the live Pricing tab for the rates that apply to your account.
Full details, public contacts and employer enrichment do not create a second job-result event. They can increase platform usage because more source pages are collected. Duplicate, filtered, unchanged and failed jobs receive no saved-job event; work needed to evaluate them still consumes resources.
Use Maximum charge per run to control event charges and start with a small sample. Memory is fixed at 256 MB for the tested release. The Actor does not silently increase memory, enable a paid external data service, or create scheduled jobs on your behalf.
❓ Frequently asked questions
Why are salaries missing? Not every vacancy has published pay or a public prediction. Predictions are labelled; absent values are not invented.
Why is remote status sometimes remote_or_hybrid? The advert mentions home office without specifying whether it is fully remote. The original evidence is retained.
Why did I receive fewer than maxItems jobs? The source may be exhausted, the page or charge limit may be reached, filters may exclude jobs, or a repeat-run feed may already know them. The per-query summary explains the reason.
Can several searches find the same job? Yes. A global identity check prevents duplicate saved results, including a mix of search results and direct URLs.
Why is Hiring summary empty? Turn on includeHiringInsights. Its dataset is separate from the paid job dataset.
Does every job have a recruiter email or a company rating? No. Only the source's available values are collected. Contact evidence points back to the advert.
Can I export without writing code? Yes. Use Apify's dataset export for CSV, Excel or JSON. The same datasets are available through the API and normal Apify integrations.