# Totaljobs Scraper - UK Jobs & Company Data (`studio-amba/totaljobs-scraper`) Actor

Scrape UK job listings from Totaljobs.com by keyword and location. Extract job titles, companies, salaries, locations, and apply links. No login or cookies required.

- **URL**: https://apify.com/studio-amba/totaljobs-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **Features:** Limited permissions
- **Stats:** 2 total users, 2 monthly users, 97.1% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Totaljobs Scraper do?

**Totaljobs Scraper** extracts job listings from [Totaljobs.com](https://www.totaljobs.com), one of the UK's largest job boards with tens of thousands of live vacancies across every sector. Give it a keyword and (optionally) a UK location, and it returns structured data for every matching job: title, company, salary (as advertised), location, postcode, description snippet, posting date, expiry date, and a direct link to the advert. It reads the site's own server-rendered search data, so there is no login, no cookies, and no browser automation required.

Run it on the Apify platform to get UK job market data via API, schedule recurring scrapes, and pipe results into tools like Zapier, Make, Google Sheets, Airtable, and Slack.

### How to scrape Totaljobs data

1. Go to the Totaljobs Scraper on the Apify Store.
2. Click **Try for free** to open the actor in the Apify Console.
3. Enter a search query (e.g. "accountant", "software developer", "nurse", "project manager").
4. Optionally enter a UK location (e.g. "london", "manchester", "birmingham", "leeds"). Leave it empty to search the whole UK.
5. Set the maximum number of results you want (default: 100).
6. Leave the proxy configuration on GB residential (the default) -- Totaljobs blocks datacenter IPs.
7. Click **Start** and wait for the run to finish.
8. Download your data as JSON, CSV, Excel, or HTML from the Output tab, or pull it via the Apify API.

### Why use Totaljobs Scraper?

- **UK salary benchmarking** -- compare advertised pay across roles, sectors, and cities, and track how compensation shifts over time.
- **Recruitment intelligence** -- see which companies are hiring, for what roles, and where. Spot hiring trends before your competitors do.
- **Labour market analysis** -- understand demand across sectors and regions. Which areas have the most vacancies? Which roles are in shortest supply?
- **Lead generation** -- find employers and recruitment agencies actively hiring to target with B2B services, tools, or staffing solutions.
- **Job aggregation** -- feed structured UK listings into your own job board, career site, or candidate-alert system.
- **Academic and policy research** -- clean, structured data for labour economics, skills-gap studies, and workforce reports.

### About Totaljobs.com

Totaljobs.com is one of the UK's best-known recruitment platforms, part of the StepStone group. It aggregates vacancies from thousands of employers and recruitment agencies across every sector -- technology, healthcare, finance, accountancy, engineering, retail, hospitality, and more. Key characteristics:

- **Coverage**: Nationwide UK, from London to regional towns, plus remote roles.
- **Sectors**: All major industries, from Accountancy and IT to Nursing, Construction, and Sales.
- **Salary data**: Many adverts show a specific range (e.g. "£40,000 - £50,000 per annum"); others show "Competitive" or similar placeholder text when the employer chooses not to disclose a figure.
- **Work patterns**: Full-time, part-time, contract, temporary, and permanent roles.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | string | No | Job keyword to search for. Defaults to `accountant` if empty. |
| `location` | string | No | UK location to filter by (e.g. `london`). Leave empty to search the whole UK. |
| `maxResults` | integer | No | Maximum number of listings to scrape. Default `100`. |
| `proxyConfiguration` | object | No | Apify proxy settings. Defaults to GB residential (required -- Totaljobs blocks datacenter IPs). |

#### Example input

```json
{
  "searchQuery": "software developer",
  "location": "london",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "GB"
  }
}
```

### Output

Each job listing is a flat JSON object with the following fields:

| Field | Type | Example |
|-------|------|---------|
| `jobId` | number | `106243929` |
| `jobTitle` | string | `Accountant` |
| `company` | string | `Pilgrim's Europe` |
| `companyUrl` | string | `https://www.totaljobs.com/jobs/pilgrim%e2%80%99s-europe?cmpId=1385808&cmp=1` |
| `companyLogo` | string | `https://www.totaljobs.com/companylogos/3fc37b41b299441a84ae72e92a9e3406.png` |
| `location` | string | `UB8, Uxbridge, UB8 1QJ` |
| `postCode` | string | `UB8 1QJ` |
| `salary` | string | `£40,000 - £50,000 per annum` |
| `currency` | string | `GBP` |
| `remoteOption` | string | `null` |
| `skills` | array | `null` |
| `descriptionSnippet` | string | `Job Title: Accountant...` |
| `sponsored` | boolean | `false` |
| `publishedDate` | string | `2026-06-24T15:01:06.343Z` |
| `expiryDate` | string | `2026-07-24T22:00:00Z` |
| `url` | string | `https://www.totaljobs.com/job/accountant/pilgrim-s-europe-job106243929` |
| `scrapedAt` | string | `2026-07-14T21:32:54.779Z` |

#### Example output

```json
{
  "jobId": 106243929,
  "jobTitle": "Accountant",
  "company": "Pilgrim's Europe",
  "companyUrl": "https://www.totaljobs.com/jobs/pilgrim%e2%80%99s-europe?cmpId=1385808&cmp=1",
  "companyLogo": "https://www.totaljobs.com/companylogos/3fc37b41b299441a84ae72e92a9e3406.png",
  "location": "UB8, Uxbridge, UB8 1QJ",
  "postCode": "UB8 1QJ",
  "salary": "Competitive",
  "currency": "GBP",
  "remoteOption": null,
  "skills": null,
  "descriptionSnippet": "Job Title: Accountant",
  "sponsored": false,
  "publishedDate": "2025-11-23T01:50:02.417",
  "expiryDate": "2026-01-03T08:06:09.09",
  "url": "https://www.totaljobs.com/job/accountant/pilgrim-s-europe-job106243929",
  "scrapedAt": "2026-07-14T21:32:54.779Z"
}
```

### Cost estimate

This actor is billed on Apify's Pay Per Result model. The site's search returns 25 jobs per page, so scraping is fast and lightweight -- a typical run of a few hundred listings finishes in well under a minute of compute. You pay per job returned plus a small per-run start fee, so a run that returns 500 jobs costs roughly the price of 500 results. Check the actor's pricing tab for the exact current rate.

### Limitations and known issues

- **Search results only** -- the actor reads the listing data embedded in the search pages (title, company, salary, location, snippet, dates, links). It does not open each advert to pull the full job description body. The `descriptionSnippet` field gives you the summary shown on the results page.
- **Salary as advertised** -- when an employer doesn't disclose a figure, Totaljobs shows placeholder text like "Competitive" instead of a number. The `salary` field always reflects exactly what the employer entered.
- **Sponsored/featured jobs** -- a small number of sponsored listings repeat across pages. The actor deduplicates by `jobId`, so you never get the same job twice.
- **UK focus** -- Totaljobs.com is a UK job board with Akamai bot protection. GB residential proxies (the default) are required for reliable results; datacenter proxies are blocked.
- **Result ceiling** -- deep result sets are paginated; very large `maxResults` values will walk many pages. Keep `maxResults` reasonable for the query you actually need.

### More European job scrapers

Totaljobs runs on the same platform as StepStone -- both belong to the StepStone Group:

- [StepStone Belgium](https://apify.com/studio-amba/stepstone-scraper) — vacatures on stepstone.be
- [StepStone Germany](https://apify.com/studio-amba/stepstone-de) — Stellenanzeigen on stepstone.de
- [StepStone Austria](https://apify.com/studio-amba/stepstone-at) — Stellenanzeigen on stepstone.at
- [StepStone Netherlands](https://apify.com/studio-amba/stepstone-nl) — vacatures on stepstone.nl
- [IrishJobs](https://apify.com/studio-amba/irishjobs-scraper) — Ireland's leading job board, also StepStone Group
- [Reed](https://apify.com/studio-amba/reed-scraper) — another major UK job board, with salary ranges and sectors
- [Jobsite](https://apify.com/studio-amba/jobsite-scraper), [NHS Jobs](https://apify.com/studio-amba/nhs-jobs-scraper) — more UK job market data

Browse the [Studio AMBA profile](https://apify.com/studio-amba) on the Apify Store for more European job and marketplace scrapers.

### FAQ

**Do I need a Totaljobs account or API key?**
No. This actor reads the public search results. There is no login, no cookies, and no API key required.

**Can I filter by salary, contract type, or region?**
The current version filters by keyword and location. Salary, location, and posting date are returned on every result so you can filter them yourself after scraping.

**Is scraping Totaljobs legal?**
This actor collects publicly available job listing data. You are responsible for using the data in line with the site's terms and applicable law. Do not use it to send unsolicited communications in breach of regulations.

### Related scrapers

- [EU Vacancy Feed](https://apify.com/studio-amba/eu-vacancy-feed) — runs this board alongside up to 49 other European job boards (general boards, public employment services, and sector boards), merges everything into one deduplicated feed, and flags vacancies posted on more than one board at once.

# Actor input Schema

## `searchQuery` (type: `string`):

Job keyword to search for (e.g. 'accountant', 'software developer', 'nurse', 'project manager'). Defaults to 'accountant' if empty.

## `location` (type: `string`):

UK location to filter by (e.g. 'london', 'manchester', 'birmingham', 'leeds'). Leave empty to search across the whole UK.

## `maxResults` (type: `integer`):

Maximum number of job listings to scrape.

## `proxyConfiguration` (type: `object`):

Proxy settings. Totaljobs.com is a UK site with Akamai bot protection -- GB residential proxies are required for reliable results.

## Actor input object example

```json
{
  "searchQuery": "accountant",
  "location": "london",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GB"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "accountant",
    "location": "london",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "GB"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/totaljobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "accountant",
    "location": "london",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "GB",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/totaljobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "accountant",
  "location": "london",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "GB"
  }
}' |
apify call studio-amba/totaljobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/totaljobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/zygUh3WwwnHCy6qbQ/builds/wAVeK7adi5AEUcnEX/openapi.json