Skip to content
Scrappa Get API key
Totaljobs API 1 credit / request

Totaljobs Job Search API Documentation

GET https://scrappa.co/api/totaljobs/jobs/search

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.

Totaljobs Job Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/totaljobs/jobs/search
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops
Response preview
200 OK
{
    "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"
                },
...

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.

query string Required

Job title or keywords, for example python.

Example value coffee shops
location string Optional

Place, for example London.

Example value Austin, Texas
radius integer Optional

Miles around the location, 1 to 100. UK engine only.

Example value 10
salary_min integer Optional

Minimum annual salary in GBP.

Example value 10
job_type string Optional

permanent, contract, temporary, part_time or work_from_home.

Example value example
posted_within integer Optional

1, 3, 7 or 14 days. UK engine only.

Example value 10
work_from_home boolean Optional

true or false.

Example value true
engine string Optional

uk (default) or stepstone.

Example value example
page integer Optional

Page number, default 1.

Example value 1

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data success
JSON Response
200 OK
{
    "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.

422

Invalid Page

The requested page is past the end of the result list.

422

Invalid Filter

The filter is not available on the selected engine.

503

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.