# Hays UK Scraper - Jobs & Salary Data (`studio-amba/hays-scraper`) Actor Scrape UK job listings from Hays.co.uk, one of the world's largest recruitment agencies, by keyword and location. Extract titles, salaries, consultants, industries, and apply links. No login or cookies required. - **URL**: https://apify.com/studio-amba/hays-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 $1.20 / 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. 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 ### What does Hays Scraper do? **Hays Scraper** extracts job listings from [Hays.co.uk](https://www.hays.co.uk), one of the world's largest recruitment agencies with thousands of live UK vacancies across every professional sector. Give it a keyword and (optionally) a UK location, and it returns structured data for every matching job: title, recruitment consultant and contact email, industry, specialism, salary (with the correct annual/day-rate/hourly basis), contract type, description snippet, posting date, expiry date, and a direct apply link. It reads Hays' own JSON search API, so there is no login, no cookies, and no browser automation required. Run it on the Apify platform to get UK recruitment market data via API, schedule recurring scrapes, and pipe results into tools like Zapier, Make, Google Sheets, Airtable, and Slack. ### How to scrape Hays data 1. Go to the Hays 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", "project manager", "software developer", "HR advisor"). 4. Optionally enter a UK location (e.g. "London", "Manchester", "Birmingham", "Leeds"). Leave it empty to search across the whole UK. 5. Set the maximum number of results you want (default: 100). 6. Leave the proxy configuration on GB residential (the default). 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 Hays Scraper? - **UK salary benchmarking** -- compare advertised pay across roles, sectors, and cities, with the correct annual/day-rate/hourly basis attached to every figure. - **Recruitment intelligence** -- see which consultants and specialisms are active on which roles, and spot hiring trends at one of the UK's largest agencies before your competitors do. - **Labour market analysis** -- understand demand across sectors and regions. Which areas have the most vacancies? Which specialisms are in shortest supply? - **Lead generation** -- Hays job listings surface active hiring employers by industry and region, useful for targeting B2B services, tools, or staffing solutions at companies currently recruiting. - **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 Hays.co.uk Hays is a listed, blue-chip global recruitment and staffing group operating job boards across roughly a dozen markets. Hays.co.uk is its UK business, one of the country's best-known recruitment agencies, covering thousands of live vacancies across every professional sector. Key characteristics: - **Coverage**: Nationwide UK, from London to regional towns, plus remote and hybrid roles. - **Sectors**: All major white-collar sectors -- Accountancy & Finance, IT & Technology, Construction & Property, HR, Legal, Sales & Marketing, Life Sciences, Engineering, and more. - **Confidential employers**: Hays is a recruitment agency, not a job board -- many roles are posted under Hays' own name with the actual hiring company kept confidential until a candidate applies. The scraper captures the assigned Hays consultant and their contact details instead of a company name. - **Salary data**: Most adverts show a specific range, tagged as an annual salary, a day rate (for contract/temporary roles), or an hourly rate. This actor reads that tag and formats the `salary` field accordingly (e.g. "£85,000 - £95,000 per annum" vs "£250 - £400 per day"). - **Work patterns**: Full-time, part-time, contract, and temporary 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. | #### Example input ```json { "searchQuery": "project manager", "location": "Manchester", "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` | string | `JOB_5402341` | | `jobReference` | string | `4810134` | | `jobTitle` | string | `Treasury Accountant` | | `recruiter` | string | `Hays` | | `consultant` | string | `Alex Stirling` | | `consultantEmail` | string | `Alex.Stirling@hays.com` | | `industry` | string | `Manufacturing & Production` | | `specialism` | string | `AccFin` | | `subSpecialism` | string | `TaxTreasury` | | `department` | string | `Tax and Treasury` | | `location` | string | `London` | | `salaryMin` | number | `85000` | | `salaryMax` | number | `95000` | | `currency` | string | `GBP` | | `salaryType` | string | `Annual Salary` | | `salary` | string | `£85,000 - £95,000 per annum` | | `contractType` | string | `FULL_TIME` | | `descriptionSnippet` | string | `Your new company FTSE 100 business...` | | `publishedDate` | string | `2026-07-01T00:00:00.000Z` | | `expiryDate` | string | `2026-09-29T00:00:00.000Z` | | `url` | string | `https://www.hays.co.uk/job-detail/JOB_5402341` | | `scrapedAt` | string | `2026-07-26T10:12:54.968Z` | #### Example output ```json { "jobId": "JOB_5402341", "jobReference": "4810134", "jobTitle": "Treasury Accountant", "recruiter": "Hays", "consultant": "Alex Stirling", "consultantEmail": "Alex.Stirling@hays.com", "industry": "Manufacturing & Production", "specialism": "AccFin", "subSpecialism": "TaxTreasury", "department": "Tax and Treasury", "location": "London", "salaryMin": 85000, "salaryMax": 95000, "currency": "GBP", "salaryType": "Annual Salary", "salary": "£85,000 - £95,000 per annum", "contractType": "FULL_TIME", "descriptionSnippet": "Your new company FTSE 100 business and a leader in its field is currently looking to recruit a Treasury Accountant...", "publishedDate": "2026-07-01T00:00:00.000Z", "expiryDate": "2026-09-29T00:00:00.000Z", "url": "https://www.hays.co.uk/job-detail/JOB_5402341", "scrapedAt": "2026-07-26T10:12:54.968Z" } ``` ### Cost estimate This actor is billed on Apify's Pay Per Result model. Hays' search API returns 10 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 returned by Hays' search API (title, consultant, salary, location, description snippet, dates, links). It does not open each advert to pull the full formatted job description body beyond the first ~600 characters. - **Employer names are usually not disclosed** -- Hays keeps the underlying hiring company confidential on most listings. The `consultant` and `consultantEmail` fields identify who to contact instead of a `company` field. - **Salary as advertised** -- when a role doesn't disclose a figure, the `salary` fields are `null`. The `salaryType` field tells you whether a present figure is an annual salary, a day rate, or an hourly rate. - **UK focus** -- this actor targets Hays' UK site (hays.co.uk). Hays operates similar sites in other markets; this actor does not cover those. - **Result ceiling** -- deep result sets are paginated 10 at a time; very large `maxResults` values will walk many pages. Keep `maxResults` reasonable for the query you actually need. ### More UK and European job scrapers - [Totaljobs](https://apify.com/studio-amba/totaljobs-scraper) -- another major UK job board, StepStone Group - [Jobsite](https://apify.com/studio-amba/jobsite-scraper) -- UK job listings across all sectors - [NHS Jobs](https://apify.com/studio-amba/nhs-jobs-scraper) -- UK healthcare vacancies - [IrishJobs](https://apify.com/studio-amba/irishjobs-scraper) -- Ireland's leading job board - [eFinancialCareers](https://apify.com/studio-amba/efinancialcareers-scraper) -- finance and banking jobs 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 Hays account or API key?** No. This actor reads Hays' public search results. There is no login, no cookies, and no API key required. **Why don't I see a company/employer name?** Hays is a recruitment agency. Most listings are posted under Hays' own name with the underlying employer kept confidential -- the actor returns the assigned Hays consultant and their contact email instead. **Can I filter by salary, contract type, or region?** The current version filters by keyword and location. Salary, contract type, and region are returned on every result so you can filter them yourself after scraping. **Is scraping Hays.co.uk 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', 'project manager', 'software developer', 'HR advisor'). 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. Hays.co.uk sits behind Cloudflare -- GB residential proxies are recommended 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/hays-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/hays-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/hays-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/hays-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Hays UK Scraper - Jobs & Salary Data", "description": "Scrape UK job listings from Hays.co.uk, one of the world's largest recruitment agencies, by keyword and location. Extract titles, salaries, consultants, industries, and apply links. No login or cookies required.", "version": "0.1", "x-build-id": "j7t6rbasMBk1wx6jf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~hays-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-hays-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~hays-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-hays-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~hays-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-hays-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', 'project manager', 'software developer', 'HR advisor'). 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. Hays.co.uk sits behind Cloudflare -- GB residential proxies are recommended 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 } } } } } } } } } } ```