# Stepstone API

> The Stepstone API by everydata.io returns live Stepstone data (job search & job details (de, at, be, nl)) as structured JSON: 2 endpoints under /stp, one API key, 100 free requests a month.

- URL: https://everydata.io/apis/stepstone
- Updated: 2026-10-05
- Publisher: everydata.io (https://everydata.io)

Job ads from stepstone.de, stepstone.at, stepstone.be and stepstone.nl: keyword and location search with radius, home-office and working-hours filters, paging, sorting and facet counts, plus full job details with tasks, profile, benefits, contract type, working hours, salary (published or Stepstone estimate), publication and expiry date. Field names match the freelancermap and freelance.de APIs. Company data only – contact persons, e-mails and phone numbers are redacted.

## Key facts

- Status: beta
- Endpoints: 2 (path prefix `/stp`)
- Quota: A call to the Stepstone API counts as 1 request against the monthly quota.
- Pricing: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). One quota is shared across all 34 platforms; failed requests (5xx, blocked pages) are not counted.
- Measured average response time (last 24 h): 620 ms, success rate 100% – live figures at https://everydata.io/status
- Authentication: `x-api-key` header

## Endpoints

- `GET /stp/stepstone-search-jobs` – Search jobs. Search job ads on stepstone.de (default), stepstone.at, stepstone.be or stepstone.nl by keyword and/or location (`radius` in km around the location), with paging (25 jobs per page), sorting (`relevance`, `newest`) and f… Params: `keyword`?, `location`?, `radius`?, `page`?, `sortBy`?, `remote`?, `workingHours`?, `domainCode`?.
- `GET /stp/stepstone-lookup-job` – Job details by URL. Details of a Stepstone job URL (stepstone.de/.at `/stellenangebote--…--<id>-inline.html`, stepstone.be `/jobs--…`, stepstone.nl `/banen--…`): title, company (profile URL, logo, size, rating), full description as plain t… Params: `url`.

## Example

```bash
curl -s "https://api.everydata.io/stp/stepstone-search-jobs?keyword=python&location=Berlin" \
  -H "x-api-key: YOUR_API_KEY"
```

```json
{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "domainCode": "de",
  "keyword": "python",
  "location": "Berlin",
  "resultCount": 313,
  "numberOfJobs": 25,
  "jobs": [
    {
      "jobId": 10002139,
      "title": "Senior Data Scientist (m/w/d)",
      "company": "Senacor Technologies AG",
      "location": "Berlin, Bonn, Frankfurt, Hamburg, München, Nürnberg",
      "workMode": "hybrid",
      "postedAt": "2026-09-23T18:03:05+02:00",
      "url": "https://www.stepstone.de/stellenangebote--Senior-Data-Scientist-m-w-d-...--10002139-inline.html"
    }
  ]
}
```

## Use cases

- Job aggregation & alerts
- Labour market & salary research
- Hiring-demand tracking by company
- Skill demand analysis

## FAQ

### What data does the Stepstone API return?

Job search & job details (DE, AT, BE, NL). The API has 2 endpoints under the /stp path – search jobs and job details – and every response is structured JSON that starts with responseStatus and responseMessage.

### What does “beta” mean for the Stepstone API?

The endpoints and response fields are usable today, but they can still change and the platform is not yet counted in the headline success rate. Blocked or failed calls are not billed.

### How much does the Stepstone API cost?

A call to the Stepstone API counts as 1 request against the monthly quota. The Stepstone API is included in every plan and shares one quota with all other platforms: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). Failed requests (5xx, blocked pages) are not counted.

### Is the Stepstone data realtime?

Yes. Each request loads the live Stepstone page when you call the API – there is no database of old snapshots in between.

### Do I need a Stepstone account or an official Stepstone API key?

No. You only need an everydata.io API key, sent in the x-api-key header. The free plan works without a credit card.

### Is this a Stepstone scraper?

It replaces one. everydata.io loads the live Stepstone pages for you and returns parsed JSON fields, so you do not build or maintain a Stepstone scraper, parser or proxy setup yourself. Retries are included, and a request that still fails costs no quota.

### What happens when Stepstone blocks a request?

The API retries the fetch automatically. If the page still cannot be loaded you get a 502 or 503 error, and that request costs no quota. Success rates and response times per platform are measured around the clock on the status page.

### Can ChatGPT, Claude or an AI agent use the Stepstone API?

Yes. Connect the hosted everydata.io MCP server and the assistant can call every Stepstone endpoint as a tool, or register the plain HTTPS endpoints as functions in any agent framework. The endpoint list is also in /llms.txt and the OpenAPI spec.

## More

- [All platforms](https://everydata.io/apis) · [Pricing](https://everydata.io/pricing) · [API reference](https://everydata.io/docs) · [Getting started](https://everydata.io/docs/getting-started) · [MCP server](https://everydata.io/docs/mcp) · [Status](https://everydata.io/status)
- Machine-readable: [llms.txt](https://everydata.io/llms.txt), [llms-full.txt](https://everydata.io/llms-full.txt), [OpenAPI](https://api.everydata.io/openapi.json)
