Black Falcon Data

Posted on Aug 21 Edited on Aug 24

Stepstone API data export: all 81 fields, grouped

#webscraping #api

A Stepstone record contains 81 fields. This page shows which are populated, which are optional, and what a real row looks like — the data the Stepstone API has to work with.

It also covers what our own Stepstone Actor returns, how much it costs, and where its limits are.

Every field

Each record includes 81 fields, divided into several groups:

company — company, companyId, companyLogo, companyUrl, companyWebsite, companyEmployees, companyIndustries, companyBenefits, companyAddress, companyRating
is — isSponsored, isTopJob, isPartnershipJob, isAnonymous, isHighlighted, isRepost
salary — salaryText, salaryMin, salaryMax, salaryCurrency, salaryPeriod
description — description, descriptionHtml, descriptionMarkdown, descriptionLength
contact — contactName, contactEmail, contactPhone
text — textSections, textSnippet, textSnippetCleaned
extracted — extractedEmails, extractedPhones, extractedUrls
apply — applyEmail, applyUrl
location — location, locationDetail
work — workFromHome, workFromHomeLabel
publish — publishFromDate, publishToDate
source — sourceUrl, sourceDomain
content — contentQuality, contentHash
repost — repostOfId, repostDetectedAt

Here is a returned record, shortened for readability:

{
 "jobId": "f4dbe212ce1aaee33f980edd5cbaefbc63c87b29fd1be7fd7075724b72910573",
 "harmonisedId": "0a9b9217-5b2a-4e2e-9ff8-ce4980f4c082",
 "legacyJobId": 13817131,
 "title": "Software Engineer Public Sector (all genders)",
 "company": "msg systems ag",
 "companyId": 5245,
 "companyLogo": "https://www.stepstone.de/upload_DE/logo/1/logomsg-systems-gmbh-5245DE-2207011009.gif",
 "companyUrl": "https://www.stepstone.de/cmp/de/msg-systems-ag-5245/jobs",
 "companyWebsite": null,
 "companyEmployees": null,
 "companyIndustries": [],
 "companyBenefits": [],
 "companyAddress": null,
 "contactName": null
}

Filters that narrow a run

The input accepts 47 options, including query, location, startUrls, bundesland, sort, age, remote, radius, minSalary, contractType, experience, workType, companyId, language, applicationMethod, excludeSponsored, includeDetails, descriptionFormat, maxResults, maxPages, and more. Because the filters run server-side, you pay only for the requested records instead of filtering them afterwards.

What it costs

Pricing is per event, with no subscription:

$0.005 per actor start
$0.0015 per result

Here are the results from a measured run, not an estimate:

25 records in 24.9 seconds
cost: $0.03 — about $1.12 per 1,000 records

What people use it for

Benchmarking. Pricing and salary fields support comparisons across the whole set instead of forcing you to eyeball a page of results.
Reputation monitoring. Tracking ratings and review text over time reveals movement that one page view cannot show.
Lead lists. Company-level fields help you isolate the relevant segment before anyone opens a CRM.
Change detection. Timestamps allow you to diff runs and respond to new information instead of re-reading everything.
Geographic analysis. Location fields provide market-by-market comparisons without requiring a separate data source.

What it will not do

An empty field means the source showed nothing. Values are never inferred or filled in from elsewhere.
The schema follows Stepstone's markup. A redesign can therefore add, rename or drop fields.
By design, anything Stepstone places behind a login is absent from every field below.

Questions people ask

Are all fields always populated?

No, and missing values are not guessed. When the source leaves a field blank, it comes back blank. An empty value means Stepstone did not show one, not that extraction failed.

Which markets does it cover?

The location option narrows the run before any records are produced. You pay for the requested market instead of filtering afterwards.

Which filters are applied at the source?

minSalary, contractType, workType, maxResults run server-side. That affects cost as well as convenience: filtered-out records are never produced and therefore never billed.

How fresh is the data?

Every run reads Stepstone when it runs, with no cached copy in between. Running it twice, one week apart, produces two snapshots and makes change detection possible.

Can I fetch only what changed?

Use incrementalMode for that. Without it, a re-run returns the full set again, leaving deduplication to your side.

Is there an official Stepstone export?

No. There is no public bulk export or API, so the field list above comes from parsing pages rather than a documented schema.

Try it

If these are the fields you need, the Stepstone API we keep working produces them. New accounts receive $5 of free platform credit each month, enough to cover a real run of this size several times over.

Disclosure: we build and maintain this Actor, and the link above is an affiliate link.

DEV Community