# 🇬🇧 Reed UK Jobs Scraper | Listings & Salaries (`antique_sundew/reed-uk-jobs-scraper`) Actor

Scrape Reed.co.uk job vacancies, salary bands, recruiter details, locations, and requirements across the UK. Fast HTTP scraper for UK hiring data.

- **URL**: https://apify.com/antique\_sundew/reed-uk-jobs-scraper.md
- **Developed by:** [Alexandru Afanasiuc](https://apify.com/antique_sundew) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 job scrapeds

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

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Reed.co.uk Scraper — UK Jobs, Salaries, Employers & Locations

Extract structured job listings from **Reed.co.uk**, one of the UK's largest job boards. Search by keyword and location and get clean JSON/CSV with titles, published salaries, employers, job types and direct application links.

### Why use this scraper

- **Salary as published** — Reed employers disclose salary more often than most UK boards; you get the exact text (`£35,000 - £45,000 per annum`). When it is not disclosed, the field is `null` — never guessed.
- **Direct application links** — every row links straight to the posting.
- **Job types included** — permanent, contract, part-time, as the board publishes them.
- **Zero-billed empty searches** — an unrecognised search returns zero rows and costs nothing.
- **Pure HTTP** — no browser, fast, cheap; a 100-job run typically finishes in seconds.

### What data you get

```json
{
  "id": "51234567",
  "title": "Software Engineer",
  "url": "https://www.reed.co.uk/jobs/software-engineer/51234567",
  "salary": "£45,000 - £55,000 per annum",
  "company": "Example Recruitment Ltd",
  "location": "Manchester",
  "jobType": "Permanent",
  "scrapedAt": "2026-08-11T10:00:00.000Z"
}
```

Fields the posting does not include are `null` — this Actor never invents data.

### How to run it

1. Set `keywords` (e.g. `"developer"`, `"warehouse operative"`, `"registered nurse"`).
2. Set `location` (e.g. `"london"`, `"manchester"`, `"birmingham"`).
3. Click **Start** and export the dataset as JSON, CSV or Excel.

Works out of the box: the default input (`developer` in `london`, 100 items) runs successfully with no changes.

### Input parameters

| Field | Type | Default | Description |
|---|---|---|---|
| `keywords` | string | `"developer"` | Search terms. |
| `location` | string | `"london"` | UK city or region. |
| `maxItems` | integer | `100` | Cap on returned jobs. |

### Pricing

**$3.00 per 1,000 jobs** (pay per event, no subscription). Examples:

- 100 jobs → **$0.30**
- 500 jobs → **$1.50**
- Zero results → **$0.00**.

### Use cases

- **Job alerts** — schedule daily runs per keyword/city and push new rows to Sheets, Slack or email.
- **UK salary research** — Reed's high salary-disclosure rate makes it the best UK board for comparing published ranges.
- **Recruitment intelligence** — track which employers and recruiters post most in a sector.
- **Relocation research** — same keyword across cities, compare volume and pay.
- **AI agents** — call this Actor as a tool through the [Apify MCP server](https://mcp.apify.com/?actors=antique_sundew/reed-uk-jobs-scraper).

### Limitations

- Returns what the Reed results feed publishes; per-posting page details (full description text) are out of scope.
- One keyword string and one location per run — loop over combinations with Schedules or API calls.
- Postings by anonymous recruiters carry the recruiter name Reed shows, which may be an agency.

### FAQ

**How do I scrape Reed.co.uk without coding?**
Run this Actor from the Apify Console — set keyword and city, press Start, export CSV.

**Does it return salaries?**
Yes, exactly as published, in the `salary` field — Reed postings disclose them unusually often. `null` when the employer hides it.

**Can I search all of the UK?**
Set `location` to a broad region or run several cities on a Schedule.

**Is this the official Reed API?**
No — it reads the public search results, the same ones a visitor sees, without login.

### Related Actors

- [StepStone NL/BE/AT & Totaljobs UK Scraper](https://apify.com/antique_sundew/stepstone-nl-scraper) — includes Totaljobs UK
- [Pracuj.pl Scraper](https://apify.com/antique_sundew/pracuj-scraper) — Poland's largest job board
- [eJobs.ro Scraper](https://apify.com/antique_sundew/ejobs-scraper) — Romania's largest job board

***

If this Actor saved you time, a short review on its Store page helps other people find it. If something looks wrong, open an issue on the **Issues** tab — issues get answered.

# Actor input Schema

## `keywords` (type: `string`):

Job title or skill (e.g. 'developer', 'nurse', 'accountant', 'manager', 'electrician').

## `location` (type: `string`):

UK city or county (e.g. 'london', 'manchester', 'birmingham', 'leeds', 'bristol').

## `maxItems` (type: `integer`):

Maximum number of UK job ads to return.

## Actor input object example

```json
{
  "keywords": "developer",
  "location": "london",
  "maxItems": 100
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("antique_sundew/reed-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("antique_sundew/reed-uk-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 antique_sundew/reed-uk-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,antique_sundew/reed-uk-jobs-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DBu23F0PW3PuNgn8E/builds/fwPiWJNtQmlgo4IS4/openapi.json