Adzuna UK Scraper

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 — 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

{
  "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

{
  "keywords": "software developer",
  "location": "London",
  "maxItems": 200
}

2. With filters — permanent full-time nurse jobs, last 7 days

{
  "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

{
  "keywords": "data analyst",
  "location": "Edinburgh",
  "maxItems": 500,
  "appId": "YOUR_APP_ID",
  "appKey": "YOUR_APP_KEY"
}

4. Daily feed — new jobs only, skip already-processed

{
  "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.