# StepStone job posting: `POST /v1/stepstone/job`

Cost: 2 credits (2 (an unknown or offline posting and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/stepstone-job

One StepStone posting in full, by `job_id` or its link.

The full description as text and HTML, and split into StepStone's
own sections where the employer used them (`introduction`, `tasks`,
`requirements`, `benefits`, `contact`); the schema.org
`employment_type` (`FULL_TIME`, `PART_TIME`, ...) plus StepStone's
contract and work type in the site's language; the salary (shown or
StepStone's estimate, flagged `estimated`); the company with its
sectors and size; posting and expiry times; and the apply link.

`apply_url` is the StepStone posting: StepStone runs the apply step
itself (`easy_apply: true` is its short form), and the employer's
own application link is not on the public page. `online: false`
marks a posting StepStone still shows after it went offline. A
posting StepStone no longer serves, or an unknown id, is a 404 and
is not billed. A refusal or a spent
time budget is 503 with `Retry-After` and is not billed.

Request body (JSON):

- `job_id` (string | null; optional; pattern ^\d{5,12}$): StepStone's numeric listing id: `job_id` of a row from `POST /v1/stepstone/jobs`.
- `url` (string | null; optional; min length 12, max length 2000): A StepStone posting link instead of `job_id` (`…--<id>-inline.html` on stepstone.de/.at/.be/.nl); its site sets the country.
- `country` (string | null; optional; one of de, at, be, nl): StepStone site of `job_id` (default `de`). With `url` it must match the link's site, or be left out.

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)
