# Totaljobs Jobs Scraper (`bovi/totaljobs-jobs-scraper`) Actor Scrape job listings from Totaljobs. Extract job titles, company names, locations, salaries, posting dates, and full job descriptions for research and analytics purposes. - **URL**: https://apify.com/bovi/totaljobs-jobs-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Jobs - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.31 / 1,000 job listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Totaljobs Jobs Scraper — UK Job Listings ### What does Totaljobs Jobs Scraper do Totaljobs Jobs Scraper collects publicly available job listings from [totaljobs.com](https://www.totaljobs.com/), a UK job board. It can be used to retrieve jobs matching a keyword and location, then save the listing data to an Apify dataset. The actor follows Totaljobs search result pages and processes listings until the requested maximum number of jobs is reached or no more result pages are available. Each dataset item represents one job listing. Collected records include the job title, employer, location, salary information when shown, job type, posting date, job URL, and the available listing description or summary. Some fields may be empty when the corresponding information is not displayed in the public listing. Use the actor only for data that is publicly accessible on Totaljobs and in accordance with the website's applicable terms and policies. ### Input Configure the actor with the job search criteria and the number of listings to collect. | Field | Type | Description | | --- | --- | --- | | `keyword` | string | Job title, skill, profession, or other search term to use on Totaljobs. For example, `data analyst`, `nurse`, or `software engineer`. | | `location` | string | UK location to search in. This can be a city, region, county, or other location accepted by Totaljobs, such as `London`, `Manchester`, or `Birmingham`. | | `max_results` | integer | Maximum number of job listings to collect. The actor stops when this limit is reached or when no additional listings are available. | Example input: ```json { "keyword": "software engineer", "location": "London", "max_results": 50 } ```` Use specific keywords and locations where possible. Search result availability depends on the listings currently returned by Totaljobs for the selected criteria. ### Output example The actor stores results in the default Apify dataset. A typical item can look like this: ```json { "job_title": "Software Engineer", "company_name": "Example Technology Ltd", "location": "London", "salary": "£45,000 - £60,000 per annum", "job_type": "Permanent", "posted_date": "Posted 2 days ago", "description": "We are looking for a Software Engineer to join our product development team and build scalable web applications.", "job_url": "https://www.totaljobs.com/job/software-engineer/example-technology-ltd-job123456789" } ``` Output values reflect the content available on the corresponding public job listing at the time of collection. Salary, employment type, posting date, company name, and description fields may be unavailable for some listings. Dataset records can be viewed in the Apify Console, exported as JSON, CSV, Excel, XML, or RSS, or consumed through the Apify API. ### Use cases - Build a list of current UK job opportunities for a role, skill, or location. - Monitor new vacancies for recruitment, workforce planning, or job-market research. - Compare advertised salaries, employers, locations, and contract types across searches. - Feed job-listing data into internal dashboards, spreadsheets, or reporting workflows. - Create alerts or automated pipelines for specific job keywords and UK locations. - Collect public vacancy data for labour-market analysis and trend reporting. ### Pricing This actor uses pay-per-event pricing. Charges are based on the actor's configured event pricing for collected job listings. The buyer also pays for their own Apify platform compute usage while the actor runs. Compute consumption depends on factors such as the number of requested results, available result pages, and the time required to retrieve and process listing pages. # Actor input Schema ## `keywords` (type: `string`): Search keywords to use. ## `location` (type: `string`): Location filter for the search. ## `maxResults` (type: `integer`): Maximum number of results to collect. ## `proxyConfiguration` (type: `object`): Proxy settings to use for requests. ## Actor input object example ```json { "location": "London", "maxResults": 50, "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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("bovi/totaljobs-jobs-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 = {} # Run the Actor and wait for it to finish run = client.actor("bovi/totaljobs-jobs-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 '{}' | apify call bovi/totaljobs-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/totaljobs-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Totaljobs Jobs Scraper", "description": "Scrape job listings from Totaljobs. Extract job titles, company names, locations, salaries, posting dates, and full job descriptions for research and analytics purposes.", "version": "1.0", "x-build-id": "DsUIiLDCSpWcaLCVI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~totaljobs-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-totaljobs-jobs-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/bovi~totaljobs-jobs-scraper/runs": { "post": { "operationId": "runs-sync-bovi-totaljobs-jobs-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/bovi~totaljobs-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-totaljobs-jobs-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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "minLength": 1, "type": "string", "description": "Search keywords to use." }, "location": { "title": "Location", "type": "string", "description": "Location filter for the search.", "default": "London" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of results to collect.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings to use for requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } } }, "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 } } } } } } } } } } ```