Totaljobs Job Search returns 25 public UK job listings per page from the same result list the site renders. Each job carries its numeric id, title, company id and name, full size logo url, location, post code, GBP salary text and number, posting dates in ISO 8601, labels, skills, snippet and job url. Pagination exposes page, per page, page count and total count. Facets and selected filters come from the same query.
Filters are passed to the site and checked again before an answer is sent. A page past the end returns 422; page one is never relabelled. The newer engine has no posting date filter, so posted_within is refused there. A request costs 1 credit. A failed request is not charged.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
8 optional filters available.
string
Required
Job title or keywords, for example python.
coffee shops
string
Optional
Place, for example London.
Austin, Texas
integer
Optional
Miles around the location, 1 to 100. UK engine only.
10
integer
Optional
Minimum annual salary in GBP.
10
string
Optional
permanent, contract, temporary, part_time or work_from_home.
example
integer
Optional
1, 3, 7 or 14 days. UK engine only.
10
boolean
Optional
true or false.
true
string
Optional
uk (default) or stepstone.
example
integer
Optional
Page number, default 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
success
{
"data": {
"jobs": [
{
"id": "108334869",
"url": "/job/machine-learning-engineer/client-server-job108334869",
"title": "Machine Learning Engineer",
"salary": {
"max": 100000,
"min": 85000,
"raw": "\u00a385000 - \u00a3100000 per annum",
"unit": "year",
"currency": "GBP"
},
"date_posted": "2026-11-17T14:38:29Z"
}
],
"pagination": {
"page": 1,
"total": 2403,
"per_page": 25,
"has_next_page": true
}
},
"success": true
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Invalid Page
The requested page is past the end of the result list.
Invalid Filter
The filter is not available on the selected engine.
Upstream Unavailable
The source could not be reached. The request is not charged.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.