# Jobsite UK Jobs Scraper (`automation-lab/jobsite-uk-jobs-scraper`) Actor Scrape Jobsite.co.uk UK job listings by keyword, location, radius, posting age, or search URL. Export salary, company, dates, snippets, and apply links. - **URL**: https://apify.com/automation-lab/jobsite-uk-jobs-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.02 / 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 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 ## Jobsite UK Jobs Scraper ### What does Jobsite UK Jobs Scraper do? - Jobsite UK Jobs Scraper extracts public job listings from Jobsite.co.uk and saves clean structured data to an Apify dataset. - Use it to collect UK vacancies by keyword, location, radius, posting age, or pasted Jobsite search URLs. - The actor returns job title, employer, salary text, parsed salary values, location, dates, snippets, apply URLs, and scrape metadata. ### Who is it for? - Recruitment agencies can monitor hiring demand and source leads by role or region. - Job-board operators can collect public listings for aggregation and quality checks. - Labor-market analysts can track salary ranges, posting volumes, and employer activity. - Sales teams can identify companies currently hiring for target roles. ### Why use this Jobsite scraper? - It uses the public Jobsite search-result data and does not require a Jobsite account. - It supports both search filters and direct Jobsite search URLs. - It deduplicates jobs by stable Jobsite ID and keeps pagination conservative. - It is designed for repeat monitoring workflows with predictable dataset columns. ### What data can you extract? - The dataset contains one row per job listing. - Fields include title, company, company URL, logo URL, location, postcode, salary text, parsed salary min/max/currency/period, dates, labels, skills, snippet, apply URL, canonical job URL, source URL, page, position, and scrape timestamp. ### How much does it cost to scrape Jobsite UK jobs? - This actor uses pay-per-event pricing: a small start event plus a per-job listing event. - You only pay for listings that are saved to the dataset. - Keep `maxItems` low for test runs, then increase it for production monitoring. ### How to scrape Jobsite jobs - 1. Enter one or more keywords such as `python`, `nurse`, or `sales manager`. - 2. Optionally enter a UK location such as London, Manchester, Bristol, or a postcode. - 3. Choose radius and posted-within filters. - 4. Set `maxItems` to the number of listings you need. - 5. Run the actor and export the dataset as JSON, CSV, Excel, or via API. ### Input options - `keywords` searches Jobsite by title, skill, or hiring term. - `location` narrows the search to a UK place. - `radiusMiles` controls the area around the location. - `postedWithinDays` limits results to recent postings; use `0` for any time. - `startUrls` lets you paste existing Jobsite search URLs. - `useApifyProxy` is optional and off by default. ### Output example - Each dataset item is a structured job record. - Example fields: `jobId`, `title`, `company`, `location`, `salaryText`, `salaryMin`, `salaryMax`, `postedAt`, `expiresAt`, `descriptionSnippet`, `applyUrl`, `jobUrl`, and `scrapedAt`. ### Tips for better results - Use specific keywords for cleaner output, for example `senior python developer` instead of `developer`. - Use a location plus radius when you need local hiring data. - Use posted-within filters for monitoring fresh leads. - Use start URLs when you already built a search in the Jobsite website UI. ### Integrations - Send the dataset to Google Sheets for recruiter workflows. - Connect to a CRM to create hiring-intent company leads. - Use webhooks to trigger alerts when new jobs appear. - Export CSV or Excel for labor-market reporting. - Use the Apify API to schedule daily or weekly monitoring. ### API usage - Node.js: call `automation-lab/jobsite-uk-jobs-scraper` with the Apify client and pass the input JSON. - Python: use `apify-client` and call the actor with the same input object. - cURL: POST to the actor run-sync endpoint and download dataset items from the returned dataset URL. ### MCP usage Use the Apify MCP server with tools scoped to `automation-lab/jobsite-uk-jobs-scraper`. ```bash claude mcp add apify https://mcp.apify.com/?tools=automation-lab/jobsite-uk-jobs-scraper ```` ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com/?tools=automation-lab/jobsite-uk-jobs-scraper" } } } ``` Example prompts showing MCP usage: - “Use MCP to run the Jobsite UK Jobs Scraper for Python jobs in London and summarize salary bands.” - “Monitor nurse jobs around Manchester and list employers hiring this week.” - “Scrape this Jobsite search URL and return title, company, salary, apply URL, and job URL.” ### Proxy and reliability - Direct requests are used by default because Jobsite public mobile HTML usually contains the required data. - If your environment is blocked, enable Apify Proxy in the input. - The actor retries temporary request failures and stops gracefully on empty result pages. ### Legal and ethical notes - This actor extracts public job search results. - Review Jobsite.co.uk terms and applicable laws before using scraped data. - Do not use the output for spam, discrimination, or prohibited profiling. - Respect privacy and only process personal data when you have a lawful basis. ### Related scrapers - Explore related Apify actors from automation-lab for jobs, recruiting, company intelligence, leads, and market monitoring. - Use this scraper as a Jobsite-specific source in a broader UK hiring intelligence workflow. ### FAQ - Can I scrape multiple keywords? Yes, add multiple strings to `keywords`. - Can I scrape a Jobsite URL directly? Yes, paste it into `startUrls`. - Why did I get zero results? The keyword/location may have no current listings or the posted-within filter may be too strict. - Does it fetch full job detail pages? The MVP focuses on reliable search-result fields; detail-page enrichment may be added later. - Do I need a Jobsite account? No. The actor uses public pages. ### Troubleshooting - If results look too broad, add a location and lower the radius. - If a run is blocked by network conditions, enable Apify Proxy and retry with a small `maxItems`. - If salary parsing is empty, check `salaryText`; some jobs list “Competitive” instead of numeric salary. ### Dataset fields reference - `jobId` is the stable Jobsite listing ID. - `applyUrl` is the Jobsite apply redirect URL. - `jobUrl` is the canonical Jobsite job path when available. - `sourceUrl` is the search URL where the listing was discovered. - `positionAbsolute` helps analyze ranking within search results. ### Example input ```json { "keywords": ["python"], "location": "London", "radiusMiles": 10, "postedWithinDays": 7, "maxItems": 100 } ``` ### Node.js client example ```js import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor("automation-lab/jobsite-uk-jobs-scraper").call({ keywords: ["python"], location: "London", maxItems: 100 }); console.log(run.defaultDatasetId); ``` ### Python client example ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("automation-lab/jobsite-uk-jobs-scraper").call(run_input={"keywords": ["nurse"], "location": "Manchester", "maxItems": 100}) print(run["defaultDatasetId"]) ``` ### cURL example ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~jobsite-uk-jobs-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d "{"keywords":["data engineer"],"location":"Bristol","maxItems":100}" ``` ### Operational note 161 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 165 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 169 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 173 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 177 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 181 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 185 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 189 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 193 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 197 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 201 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 205 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Operational note 209 - Start with a small run, review the dataset, then scale `maxItems` for recurring monitoring. ### Legality Jobsite UK Jobs Scraper collects public job-search result information. You are responsible for using the data lawfully, respecting Jobsite.co.uk terms, and following privacy, employment, and anti-spam rules that apply to your workflow. ### MCP setup with Claude Code You can connect this actor to Claude Code through Apify MCP and then ask Claude to run searches, compare roles, or summarize salary bands. ```bash claude mcp add apify https://mcp.apify.com/?tools=automation-lab/jobsite-uk-jobs-scraper ``` ### MCP JSON configuration Use this configuration pattern in MCP clients that accept JSON server definitions: ```json { "mcpServers": { "apify-jobsite": { "url": "https://mcp.apify.com/?tools=automation-lab/jobsite-uk-jobs-scraper" } } } ``` ### MCP example prompts - “Run the Jobsite UK Jobs Scraper for Python jobs in London and summarize the top salary ranges.” - “Find nurse jobs near Manchester from the last 14 days and list the most active employers.” - “Scrape this Jobsite search URL and create a CSV-ready table with title, company, salary, and apply URL.” ### MCP integration Connect this actor through the Apify MCP server so Claude can run Jobsite searches and analyze the returned dataset. ```bash claude mcp add apify https://mcp.apify.com/?tools=automation-lab/jobsite-uk-jobs-scraper ``` ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com/?tools=automation-lab/jobsite-uk-jobs-scraper" } } } ``` Example MCP prompts: - “Use the Jobsite UK Jobs Scraper to collect Python jobs in London and summarize salary ranges.” - “Run a Jobsite nurse jobs search near Manchester and list employers hiring this week.” - “Scrape this Jobsite URL and return a table with title, company, salary, job URL, and apply URL.” # Actor input Schema ## `keywords` (type: `array`): Job titles, skills, or hiring terms to search on Jobsite.co.uk. Use one or more terms such as Python, nurse, driver, or sales manager. ## `location` (type: `string`): Optional UK city, region, or postcode. Leave empty to search all UK jobs. ## `radiusMiles` (type: `integer`): Search radius around the location. Jobsite commonly supports values such as 5, 10, 20, 30, and 50 miles. ## `postedWithinDays` (type: `integer`): Limit listings to jobs posted recently. Use 0 for any time; common values are 1, 3, 7, 14, or 30. ## `sortBy` (type: `string`): Sort Jobsite search results by relevance or date. ## `startUrls` (type: `array`): Optional Jobsite.co.uk search result URLs to scrape directly. If provided, the actor will scrape these plus any keyword searches. ## `maxItems` (type: `integer`): Maximum number of job listings to save across all keywords and URLs. ## `useApifyProxy` (type: `boolean`): Enable Apify Proxy if your network is blocked by Jobsite. Direct requests are used by default because the public mobile HTML usually works without a proxy. ## `proxyGroups` (type: `array`): Optional Apify Proxy groups to use when proxy mode is enabled. Leave empty for automatic proxy selection. ## Actor input object example ```json { "keywords": [ "python" ], "location": "London", "radiusMiles": 10, "postedWithinDays": 7, "sortBy": "relevance", "startUrls": [ { "url": "https://www.jobsite.co.uk/jobs/python/in-london?radius=10&postedwithin=7" } ], "maxItems": 20, "useApifyProxy": false, "proxyGroups": [] } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "python" ], "location": "London", "radiusMiles": 10, "postedWithinDays": 7, "sortBy": "relevance", "startUrls": [ { "url": "https://www.jobsite.co.uk/jobs/python/in-london?radius=10&postedwithin=7" } ], "maxItems": 20, "useApifyProxy": false, "proxyGroups": [] }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/jobsite-uk-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 = { "keywords": ["python"], "location": "London", "radiusMiles": 10, "postedWithinDays": 7, "sortBy": "relevance", "startUrls": [{ "url": "https://www.jobsite.co.uk/jobs/python/in-london?radius=10&postedwithin=7" }], "maxItems": 20, "useApifyProxy": False, "proxyGroups": [], } # Run the Actor and wait for it to finish run = client.actor("automation-lab/jobsite-uk-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 '{ "keywords": [ "python" ], "location": "London", "radiusMiles": 10, "postedWithinDays": 7, "sortBy": "relevance", "startUrls": [ { "url": "https://www.jobsite.co.uk/jobs/python/in-london?radius=10&postedwithin=7" } ], "maxItems": 20, "useApifyProxy": false, "proxyGroups": [] }' | apify call automation-lab/jobsite-uk-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/jobsite-uk-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jobsite UK Jobs Scraper", "description": "Scrape Jobsite.co.uk UK job listings by keyword, location, radius, posting age, or search URL. Export salary, company, dates, snippets, and apply links.", "version": "0.1", "x-build-id": "nMOT7PEtSaQmgGFYD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~jobsite-uk-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-jobsite-uk-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/automation-lab~jobsite-uk-jobs-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-jobsite-uk-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/automation-lab~jobsite-uk-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-jobsite-uk-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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Job titles, skills, or hiring terms to search on Jobsite.co.uk. Use one or more terms such as Python, nurse, driver, or sales manager.", "default": [ "python" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Optional UK city, region, or postcode. Leave empty to search all UK jobs." }, "radiusMiles": { "title": "Radius in miles", "minimum": 0, "maximum": 100, "type": "integer", "description": "Search radius around the location. Jobsite commonly supports values such as 5, 10, 20, 30, and 50 miles.", "default": 10 }, "postedWithinDays": { "title": "Posted within days", "minimum": 0, "maximum": 30, "type": "integer", "description": "Limit listings to jobs posted recently. Use 0 for any time; common values are 1, 3, 7, 14, or 30.", "default": 7 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort Jobsite search results by relevance or date.", "default": "relevance" }, "startUrls": { "title": "Jobsite search URLs", "type": "array", "description": "Optional Jobsite.co.uk search result URLs to scrape directly. If provided, the actor will scrape these plus any keyword searches.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of job listings to save across all keywords and URLs.", "default": 20 }, "useApifyProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Enable Apify Proxy if your network is blocked by Jobsite. Direct requests are used by default because the public mobile HTML usually works without a proxy.", "default": false }, "proxyGroups": { "title": "Proxy groups", "type": "array", "description": "Optional Apify Proxy groups to use when proxy mode is enabled. Leave empty for automatic proxy selection.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```