# 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 - **Stats:** 2 total users, 1 monthly users, 100.0% 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # 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. ### Related scrapers - **IrishJobs Scraper** -- Ireland's leading job board, same StepStone platform. - **StepStone Scraper** -- Belgium, Germany, and Austria job listings. - **Reed Scraper** -- another major UK job board, with salary ranges and sectors. - Browse the Studio AMBA profile 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. ### Need this data on a schedule, or a custom version? We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API -- maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed. See [studioamba.dev/services](https://studioamba.dev/services/) or email for a free data sample. We maintain 300+ European web scrapers and answer within one business day. # 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" } } ``` # 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 '' with your token const client = new ApifyClient({ 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 '' with your token. client = ApifyClient("") # 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/totaljobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Totaljobs Scraper - UK Jobs & Company Data", "description": "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.", "version": "0.1", "x-build-id": "4N5TmLbtqH5GFfFKj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~totaljobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-totaljobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~totaljobs-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-totaljobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~totaljobs-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-totaljobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Job keyword to search for (e.g. 'accountant', 'software developer', 'nurse', 'project manager'). Defaults to 'accountant' if empty." }, "location": { "title": "Location", "type": "string", "description": "UK location to filter by (e.g. 'london', 'manchester', 'birmingham', 'leeds'). Leave empty to search across the whole UK." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job listings to scrape.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Totaljobs.com is a UK site with Akamai bot protection -- GB residential proxies are required for reliable results." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```