StepStone API: Search jobs (v1)

Returns one page of 25 jobs with company, salary, work mode and posting dates. UK boards serve at most 4 pages (100 jobs) per search, StepStone sites 6 to 10, and deep pages are sometimes refused; split a broad search by location or posting age to reach more.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

site?string

Which job board to search: stepstone_de, stepstone_at and stepstone_be (StepStone Germany, Austria and Belgium), or the UK boards totaljobs, cwjobs and caterer (Caterer.com).

Default"stepstone_de"

Value in

"stepstone_de"
"stepstone_at"
"stepstone_be"
"totaljobs"
"cwjobs"
"caterer"

query*string

Job title, skill or keywords, as typed into the site's own search box.

Length1 <= length <= 200

location?string

City, region or postcode area in the site's country, such as London or Berlin. Omit to search the whole country.

Lengthlength <= 120

Default""

page?integer

One-based page of 25 jobs. The UK boards serve at most 4 pages (100 jobs) per search, StepStone Austria and Belgium 6 and StepStone Germany 10, where pages after 7 are sometimes refused. To reach more jobs, split a broad search by location or posted_within_days.

Range1 <= value <= 10

Default1

sort?string

relevance (the default) uses the site's own ranking. date lists the newest postings first, and the sites match the query more loosely in that order.

Default"relevance"

Value in

"date"
"relevance"

posted_within_days?|

Keep only jobs posted in the last N days. Totaljobs, CWJobs and Caterer.com take 1, 3, 7 or 14; the StepStone sites take 1 or 7. Other values are rejected.

work_mode?string

Keep only jobs with this work arrangement. Totaljobs, CWJobs and Caterer.com take office or remote; the StepStone sites take remote (fully remote) or hybrid (partly remote).

Value in

"office"
"remote"
"hybrid"

curl -X GET "https://example.com/v1/stepstone/search?query=data+analyst" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "site": "totaljobs",    "query": "data analyst",    "location": "London",    "page": 1,    "sort": "relevance",    "total": 463,    "total_breakdown": {      "exact": 109,      "nearby": 277,      "related": 77,      "recommended": 0    },    "page_size": 25,    "max_page": 4,    "has_more": true,    "count": 0,    "url": "string",    "stop_reason": "page_limit",    "results": [      {        "job_id": "108280317",        "title": "Data Analyst",        "url": "https://www.totaljobs.com/job/data-analyst/lorien-resourcing-limited-job108280317",        "company": {          "name": "Lorien Resourcing Limited",          "id": "1203473",          "url": "string",          "logo_url": "string"        },        "location": "London",        "postal_code": "string",        "salary": {          "label": "Up to £220 per day",          "min": 52000,          "max": 69000,          "currency": "EUR",          "period": "year",          "estimated": true        },        "work_mode": "hybrid",        "description_snippet": "string",        "posted_at": "2026-11-04T07:51:50.473Z",        "expires_at": "2026-11-11T07:51:50.473Z",        "match_type": "exact",        "is_sponsored": true,        "is_top_job": true,        "skills": [          "string"        ],        "labels": [          "Easy Apply"        ]      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}