Skip to main content
GET
Get Scrape Stepstone Jobs Status
Poll until status is COMPLETED or FAILED. The result field is populated on completion. Page through the returned jobs with the limit (1–50, default 25) and offset query params; the response echoes limit, offset, and has_more.
result.total_found is how many jobs this run stored — the set limit/offset page against — not how many matches Stepstone advertised for the search. The board’s own match count is larger and is not what pagination is computed from.
Polling guidance: Check every 15–30 seconds. Searches that fetch full descriptions take a little longer than listing-only ones.
An empty jobs array means the search matched nothing. If Stepstone refused the request instead, the run still completes but result.warnings says so explicitly — treat a warning there as “retry shortly”, not as “no jobs found”.

Example responses

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

request_id
string
required

The run_... id returned by the scrape endpoint.

Query Parameters

limit
integer
default:25

Max jobs to return (pagination page size).

Required range: 1 <= x <= 50
offset
integer
default:0

Number of jobs to skip (pagination offset).

Required range: x >= 0

Response

Successful Response

request_id
string
required
status
string
required

Run lifecycle: QUEUED, RUNNING, COMPLETED, or FAILED.

result
StepstoneResult · object | null

Populated only when status is COMPLETED; null otherwise.

started_at
string | null
finished_at
string | null