# StepStone job search: `POST /v1/stepstone/jobs`

Cost: 2 credits (2 per page (an empty page, a page past the last one and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/stepstone-jobs

One page (up to 25) of StepStone jobs for keywords and a location.

Each row carries StepStone's numeric `job_id` (feed it to
`POST /v1/stepstone/job`), the title, company, location, posting
and expiry times, the posting link, StepStone's short snippet, the
salary when one is shown (`estimated: true` marks StepStone's own
estimate rather than the employer's figure), `home_office`,
`easy_apply` and StepStone's labels. `match_type` is `main` for a
job that matched the search and `regional`, `semantic` or
`recommended` for the broader suggestions StepStone adds to a
short result list. `total_results` is StepStone's own count; page
with `page`.

`country` picks stepstone.de (default), .at, .be or .nl. `radius`
(km around `location`), `date_posted`, `remote` and `sort` are
StepStone's own filters. An empty page, including one past the
last page, is not billed. A refusal or a spent time budget is 503
with `Retry-After` and is not billed.

Request body (JSON):

- `keywords` (string | null; optional; min length 1, max length 200): Job title, skill or company, as typed into StepStone's search.
- `location` (string | null; optional; min length 1, max length 120): City, region or postcode (StepStone's "where").
- `country` (string; optional; default de; one of de, at, be, nl): StepStone site: `de` stepstone.de, `at` stepstone.at, `be` stepstone.be, `nl` stepstone.nl.
- `radius` (integer | null; optional; min 0, max 100): Search radius around `location` in km (StepStone's default is 30; 100 is the largest it accepts). Ignored without `location`.
- `date_posted` (string | null; optional; one of 24h, 3d, 7d): Only jobs posted within the last 24 hours, 3 days or 7 days.
- `remote` (string | null; optional; one of full, partial): Home office: `full` = home office only, `partial` = partly home office.
- `sort` (string; optional; default relevance; one of relevance, date): StepStone's relevance order, or newest first (`date`).
- `page` (integer; optional; default 1; min 1, max 100): Result page, 25 jobs each.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
