Query Stepstone programmatically: 81 fields, one call

666 words ~3 min read Updated 2026-08-24

Stepstone does not publish a Stepstone API. The useful data is rendered into each page, so extracting it at volume requires an HTML parser—and ongoing work to keep that parser running.

Here is what our Stepstone Actor returns, what it costs, and where its limits are.

Calling it as an API

Start a run and wait for the dataset with one call:

curl -X POST "https://api.apify.com/v2/acts/blackfalcondata~stepstone-de-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
 -H 'Content-Type: application/json' \
 -d '{"query": "..."}'

The Python equivalent:

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("blackfalcondata~stepstone-de-scraper").call(run_input={"query": "..."})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
 print(item)

What comes back

Each record contains 81 fields, organized into several groups:

company — company, companyId, companyLogo, companyUrl, companyWebsite, companyEmployees, +4 more
is — isSponsored, isTopJob, isPartnershipJob, isAnonymous, isHighlighted, isRepost
salary — salaryText, salaryMin, salaryMax, salaryCurrency, salaryPeriod
description — description, descriptionHtml, descriptionMarkdown, descriptionLength
contact — contactName, contactEmail, contactPhone

Here is a returned record, shortened for readability:

{
 "jobId": "c1f7684b8c7fedea98417be598947dde4cc21c04552f56e9455d81522b5d04a7",
 "harmonisedId": "f28779c1-d29b-4d6c-b220-88c4d1dddd47",
 "legacyJobId": 14338941,
 "title": "Software Engineer (m/w/d)",
 "company": "IHK - Industrie- und Handelskammer zu Berlin",
 "companyId": 51093,
 "companyLogo": "https://www.stepstone.de/upload_DE/logo/I/logoIHK-Industrie-und-Handelskammer-zu-Berlin...",
 "companyUrl": "https://www.stepstone.de/cmp/de/ihk-industrie-und-handelskammer-zu-berlin-51093/jobs",
 "companyWebsite": null,
 "companyEmployees": null,
 "companyIndustries": [],
 "companyBenefits": [],
 "companyAddress": null,
 "contactName": null
}

What you give it

The input accepts 47 options, including query, location, startUrls, bundesland, sort, age, remote, radius, minSalary, contractType, and more. Filters run server-side. You pay for the records you request instead of collecting extra records and filtering them afterwards.

What it costs

Pricing is per event, with no subscription:

$0.005 per actor start
$0.0015 per result

These figures come from a measured run, not an estimate:

25 records in 66.8 seconds
cost: $0.05 — about $1.92 per 1,000 records

What it will not do

No endpoint remains stable forever. This endpoint is ours, not Stepstone's. When it changes, it changes because we changed it—not silently.
The source controls the rate, not the API. Larger runs take longer; they do not fail faster.
Content behind a Stepstone login is out of scope. Authentication on our side cannot provide access to it.

Questions people ask

Is there an official Stepstone API?

No. Stepstone publishes this data on its pages but does not provide a public API for it. Every option here therefore depends on reading those pages.

How do I authenticate?

Use an Apify API token, supplied through ?token= or an Authorization: Bearer header. The token belongs to you, not us. It is the only credential involved; you do not need a separate account on the source site.

How long does one call take?

The measured run returned 25 records in 66.8 seconds. run-sync-get-dataset-items keeps the connection open for the entire run. For large runs, start the run first and poll the dataset instead.

Can I page through results?

Runs are bounded by maxResults, not by paging through responses. You request a number of records and receive one dataset. To read that dataset in chunks, the dataset endpoint accepts offset and limit.

What format does it return?

JSON is the default. By changing the format parameter, the same run can also be served from the dataset endpoint as CSV, XLSX and JSONL. No separate export step is required.

Try it

the Stepstone API we run so you do not have to runs on Apify. The endpoint above is the complete integration. New accounts receive $5 of free platform credit each month—enough to run a job of this size several times.

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