# Adzuna UK Scraper — British Job Listings (`unfenced-group/adzuna-uk-scraper`) Actor Scrape UK job listings from Adzuna.co.uk — the UK's largest job aggregator. - **URL**: https://apify.com/unfenced-group/adzuna-uk-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.99 / 1,000 results 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 ## Adzuna UK Scraper ![Adzuna UK Scraper banner](https://i.imgur.com/PLACEHOLDER.png) Extract job listings from **Adzuna.co.uk** — the UK's largest job aggregator with over 1 million active listings across all industries and regions. --- ### Features - Search by **keywords and location** (London, Manchester, Edinburgh, Birmingham, and more) - Filter by **contract type** (permanent / contract) and **schedule** (full-time / part-time) - Filter by **recency** — limit results to jobs posted within the last N days - **90-day cross-run deduplication** — never process the same job twice - **Optional API enrichment** — add publish date, GPS coordinates, category, and contract details using free Adzuna API credentials (no extra cost) - **Optional full description** — retrieve the complete job description from the detail page - **Custom start URLs** — paste any Adzuna.co.uk search or listing URL directly --- ### Input Parameters | Parameter | Type | Description | |---|---|---| | `keywords` | String | Job search terms (e.g. `software engineer`, `nurse`) | | `location` | String | City or region (e.g. `London`, `Manchester`, `Edinburgh`) | | `maxItems` | Integer | Maximum listings to return (default: 100) | | `maxDaysOld` | Integer | Only return jobs posted within the last N days (1–30) | | `contractType` | Select | `all` / `permanent` / `contract` | | `contractTime` | Select | `all` / `full_time` / `part_time` | | `startUrls` | Array | Custom Adzuna.co.uk URLs to scrape instead of keywords | | `skipReposts` | Boolean | Skip jobs seen in previous runs | | `fetchDetails` | Boolean | Fetch full description (increases cost) | | `appId` | String | Adzuna API App ID — enables publishDate, GPS, category (optional) | | `appKey` | String | Adzuna API App Key — required with App ID (optional) | > **Get free API credentials:** Register at [developer.adzuna.com](https://developer.adzuna.com) — free tier included. --- ### Output Schema Each item in the dataset represents one job listing. #### Always present | Field | Type | Description | |---|---|---| | `id` | String | Adzuna job ID | | `url` | String | Direct link to the job listing | | `title` | String | Job title | | `location` | String | Job location | | `source` | String | Always `adzuna.co.uk` | | `currency` | String | Always `GBP` | | `contentHash` | String | Hash for change detection | | `isRepost` | Boolean | `true` if seen in a previous run | | `descriptionText` | String | Description snippet from list page | #### Conditionally present (list page) | Field | Type | Description | |---|---|---| | `company` | String | Employer name (~70% fill rate) | | `salaryText` | String | Salary as displayed, e.g. `£35,000 per year` (~25% fill rate) | | `salaryMin` | Number | Parsed salary minimum | | `salaryMax` | Number | Parsed salary maximum | | `salaryPeriod` | String | `YEAR` / `MONTH` / `HOUR` / `DAY` | #### With Adzuna API credentials (`appId` + `appKey`) | Field | Type | Description | |---|---|---| | `publishDate` | String | ISO date of posting (e.g. `2026-04-20`) | | `latitude` | Number | GPS latitude | | `longitude` | Number | GPS longitude | | `contractType` | String | `permanent` or `contract` | | `contractTime` | String | `full_time` or `part_time` | | `category` | String | Job category label (e.g. `IT Jobs`) | | `categoryTag` | String | Category slug (e.g. `it-jobs`) | | `locationArea` | Array | Location hierarchy (e.g. `["UK", "London", "City of London"]`) | | `salaryIsPredicted` | Boolean | `true` if salary is Adzuna-estimated | | `salaryMin` | Number | API salary minimum (overrides list-page value) | | `salaryMax` | Number | API salary maximum (overrides list-page value) | #### With `fetchDetails: true` | Field | Type | Description | |---|---|---| | `publishDate` | String | ISO date from job detail page | | `descriptionHtml` | String | Full job description (HTML) | | `descriptionText` | String | Full job description (plain text) | | `descriptionMarkdown` | String | Full job description (Markdown) | --- ### Example Output ```json { "id": "4198372654", "url": "https://www.adzuna.co.uk/details/4198372654", "title": "Senior Software Engineer", "company": "Acme Technologies Ltd", "location": "London, Greater London", "salaryText": "£70,000 - £85,000 per year", "salaryMin": 70000, "salaryMax": 85000, "salaryPeriod": "YEAR", "publishDate": "2026-04-21", "contractType": "permanent", "contractTime": "full_time", "category": "IT Jobs", "latitude": 51.5074, "longitude": -0.1278, "descriptionText": "We are looking for a Senior Software Engineer to join our growing team...", "isRepost": false, "source": "adzuna.co.uk", "currency": "GBP", "contentHash": "3e7fa912" } ```` *** ### Usage Examples #### 1. Basic search — developer jobs in London ```json { "keywords": "software developer", "location": "London", "maxItems": 200 } ``` #### 2. With filters — permanent full-time nurse jobs, last 7 days ```json { "keywords": "nurse", "location": "Manchester", "maxItems": 100, "maxDaysOld": 7, "contractType": "permanent", "contractTime": "full_time" } ``` #### 3. With API enrichment — adds publishDate, GPS, category at no extra cost ```json { "keywords": "data analyst", "location": "Edinburgh", "maxItems": 500, "appId": "YOUR_APP_ID", "appKey": "YOUR_APP_KEY" } ``` #### 4. Daily feed — new jobs only, skip already-processed ```json { "keywords": "accountant", "location": "Birmingham", "maxItems": 1000, "maxDaysOld": 1, "skipReposts": true, "appId": "YOUR_APP_ID", "appKey": "YOUR_APP_KEY" } ``` *** ### Performance & Pricing | Mode | Price | Notes | |---|---|---| | List-only (default) | **£0.99 / 1,000 results** | Snippet description only | | With API enrichment | **£0.99 / 1,000 results** | publishDate, GPS, category — no extra cost | | With full description | Higher | UK residential proxy required — depends on volume | > Salary data is present on approximately 25% of UK listings — employer's choice. *** ### Legal & Ethical This actor reads publicly available job listing data from Adzuna.co.uk. It complies with the Dutch AP Handreiking 2025 guidance on automated data collection. No personal data (names, emails, phone numbers) is collected. Use of this actor is subject to the [Apify Terms of Service](https://apify.com/terms-of-use). # Actor input Schema ## `keywords` (type: `string`): Job search keywords (e.g. 'software engineer', 'nurse', 'marketing manager') ## `location` (type: `string`): City or region (e.g. 'London', 'Manchester', 'Edinburgh', 'Birmingham') ## `maxItems` (type: `integer`): Maximum number of job listings to return ## `maxDaysOld` (type: `integer`): Only return jobs posted within the last N days (1–30) ## `contractType` (type: `string`): Filter by contract type ## `contractTime` (type: `string`): Filter by full-time or part-time ## `startUrls` (type: `array`): Bypass keywords/location by providing specific Adzuna.co.uk listing URLs ## `skipReposts` (type: `boolean`): Skip jobs already seen in previous runs (90-day cross-run deduplication) ## `fetchDetails` (type: `boolean`): Fetch full job description from the detail page. Adds descriptionHtml and descriptionMarkdown fields. Uses UK residential proxy — increases run cost. ## `appId` (type: `string`): Adzuna API App ID from developer.adzuna.com. Enables publishDate, GPS coordinates, contractType, and category enrichment at no extra proxy cost. ## `appKey` (type: `string`): Adzuna API App Key — required together with App ID ## Actor input object example ```json { "maxItems": 100, "contractType": "all", "contractTime": "all" } ``` # Actor output Schema ## `OUTPUT` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/adzuna-uk-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("unfenced-group/adzuna-uk-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 unfenced-group/adzuna-uk-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/adzuna-uk-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Adzuna UK Scraper — British Job Listings", "description": "Scrape UK job listings from Adzuna.co.uk — the UK's largest job aggregator.", "version": "0.0", "x-build-id": "hvGLU7Npi0RfQKN7F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~adzuna-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-adzuna-uk-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/unfenced-group~adzuna-uk-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-adzuna-uk-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/unfenced-group~adzuna-uk-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-adzuna-uk-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": "string", "description": "Job search keywords (e.g. 'software engineer', 'nurse', 'marketing manager')" }, "location": { "title": "Location", "type": "string", "description": "City or region (e.g. 'London', 'Manchester', 'Edinburgh', 'Birmingham')" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job listings to return", "default": 100 }, "maxDaysOld": { "title": "Max Days Old", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only return jobs posted within the last N days (1–30)" }, "contractType": { "title": "Contract Type", "enum": [ "all", "permanent", "contract" ], "type": "string", "description": "Filter by contract type", "default": "all" }, "contractTime": { "title": "Contract Time", "enum": [ "all", "full_time", "part_time" ], "type": "string", "description": "Filter by full-time or part-time", "default": "all" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Bypass keywords/location by providing specific Adzuna.co.uk listing URLs", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "skipReposts": { "title": "Skip Reposts", "type": "boolean", "description": "Skip jobs already seen in previous runs (90-day cross-run deduplication)" }, "fetchDetails": { "title": "Fetch Full Description", "type": "boolean", "description": "Fetch full job description from the detail page. Adds descriptionHtml and descriptionMarkdown fields. Uses UK residential proxy — increases run cost." }, "appId": { "title": "Adzuna App ID (optional)", "type": "string", "description": "Adzuna API App ID from developer.adzuna.com. Enables publishDate, GPS coordinates, contractType, and category enrichment at no extra proxy cost." }, "appKey": { "title": "Adzuna App Key (optional)", "type": "string", "description": "Adzuna API App Key — required together with App ID" } } }, "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 } } } } } } } } } } ```