# Reed Jobs Scraper (`spookyweb/uk-jobs-reed`) Actor

Search and export UK job vacancies from Reed with employer, location, contract type and salary, including an annualised figure so hourly and salaried roles can be compared.

- **URL**: https://apify.com/spookyweb/uk-jobs-reed.md
- **Developed by:** [丂卩ㄖㄖҜㄚ](https://apify.com/spookyweb) (community)
- **Categories:** Jobs, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.80 / 1,000 jobs

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.

- **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 Jobs Scraper

Export UK job vacancies from Reed, one of the largest job boards in the UK, with salary, employer, location and applicant counts on every result.

### 🔍 What does Reed Jobs Scraper do?

It runs a job search against Reed and returns every vacancy it finds as a clean row of data, ready for a spreadsheet, a database or your own product.

It talks to Reed's official API rather than scraping the site, because the site cannot be paged. reed.co.uk accepts a `pageno` parameter and echoes it back, then serves the same 25 jobs for every page, so a search Reed reported as 352 matches yielded 25 rows. The API returned all 304 of that same search.

You do not need a key. One is built in. Supply your own free key from [reed.co.uk/developers](https://www.reed.co.uk/developers) through the `reedApiKey` input if you would rather the requests ran against your own account.

### 📊 What data can I extract from Reed?

One item per job:

| Field | Description |
|---|---|
| `jobId`, `title`, `url` | Reed job id, title and direct link |
| `employer`, `employerId` | Hiring organisation |
| `postedBy` | Employer or Recruitment agency |
| `location` | Where the job is |
| `salaryFrom`, `salaryTo`, `salaryCurrency` | Pay as published, in the period below |
| `salaryPeriod` | Hourly, Daily, Weekly, Monthly or Annual |
| `salaryAnnualisedFrom`, `salaryAnnualisedTo` | Reed's own annual equivalent so hourly, daily and annual roles can be compared in one column |
| `hasSalary` | False when the listing hides pay, useful for filtering |
| `jobType` | Permanent, Contract or Temporary |
| `isFullTime`, `isPartTime` | Hours |
| `applications` | How many people have already applied |
| `descriptionSnippet`, `description` | Opening of the job description, and the full text when `fetchDetails` is on |
| `datePosted`, `expiryDate` | Timestamps in UTC |
| `externalUrl` | Where the application goes when it leaves Reed |
| `searchKeywords`, `searchLocation` | The search that produced the row |
| `retrievedAt` | Retrieval timestamp |

All timestamps are normalised to UTC. Reed publishes them without a timezone, so a naive parse shifts them by wherever the code happens to run.

### 💡 Why scrape Reed?

**Recruiters and agencies.** Track competing listings, salary levels and which employers are hiring.

**Market and salary research.** Build salary benchmarks by role, sector and region from published ranges.

**Job aggregators and boards.** Feed listings into your own product.

**Jobseeker tools.** Power alerts and matching with structured, deduplicated data.

### 🚀 How do I use Reed Jobs Scraper?

1. Click **Try for free**.
2. Enter what you are searching for and where, for example `warehouse` in `Manchester`.
3. Narrow it with `proximityMiles`, a salary range, contract type or `datePosted`.
4. Cap the run with `maxResults`, then click **Start**.
5. Download the results as JSON, CSV or Excel, or pull them from the API.

### ⬇️ Input

```json
{
  "keywords": "warehouse",
  "location": "Manchester",
  "proximityMiles": 20,
  "maxResults": 100
}
```

Set at least one of `keywords` or `location`.

| Field | Type | Default | What it does |
|---|---|---|---|
| `keywords` | string | `software developer` | Job title or keywords |
| `location` | string | `london` | Town, city or county |
| `proximityMiles` | integer | `10` | How far from that location to search |
| `salaryFrom` | integer | | Salary floor filter in GBP |
| `salaryTo` | integer | | Salary ceiling filter in GBP |
| `datePosted` | string | `anytime` | Any time, today, last 3 days, last week or last month |
| `permanent`, `contract`, `temporary` | boolean | `false` | Restrict by contract type |
| `fullTime`, `partTime` | boolean | `false` | Restrict by hours |
| `graduate` | boolean | `false` | Graduate roles only |
| `fetchDetails` | boolean | `true` | Add salary period, annualised pay, contract type and the full description |
| `reedApiKey` | string | | Optional, run the requests against your own free Reed key |
| `maxResults` | integer | `100` | Hard cap on billable results |

### ⬆️ Output

#### Table view

Results arrive as a table you can sort and filter in the Console. There is a second view, Salary detail, that lines up the period and the annualised figures for comparing listings against each other.

#### JSON

A typical row:

```json
{
  "title": "Warehouse Operative",
  "employer": "Best Food Logistics",
  "postedBy": "Employer",
  "location": "Oldham",
  "salaryFrom": 13.5,
  "salaryTo": 13.5,
  "applications": 379,
  "datePosted": "2026-06-19T00:00:00.000Z",
  "url": "https://www.reed.co.uk/jobs/warehouse-operative/57036090",
  "jobId": 57036090
}
```

Download it from the run as JSON, CSV or Excel, or read it straight from the API.

### How many jobs one search returns

Up to 1000 per search, in pages of 100, which is Reed's own API limit. A search
for warehouse work within 20 miles of Manchester returns just over 300 and takes
about 15 seconds.

Reed reports a total match count that is considerably larger than the number of distinct jobs it will actually serve, and it repeats listings across pages. This Actor deduplicates by job id and stops once pages stop producing anything new, so you get the real unique set rather than a padded one. Expect fewer results than the headline count Reed displays.

### Fields, and what the API does not carry

`fetchDetails` is on by default and adds the salary period, Reed's own
annualised salary, contract type, full or part time, and the complete job
description rather than a snippet. It costs one extra request per job, which is
fast enough to be worth it in almost every case. Turn it off for a quicker,
cheaper run when a title and a link are all you need.

The annualised figures come from Reed rather than being calculated here. Reed
knows the contracted hours behind an hourly rate and this actor does not, so
multiplying a rate out would be a guess dressed up as a number.

Moving to the API dropped six fields that were only ever available by scraping
the page markup: `county`, `sector`, `subSector`, `remoteOption`, `isEasyApply`
and `eligibleUkOnly`. `isPromoted` and `dateUpdated` went with them. Reed's API
does not expose any of them. In exchange every row now carries `applications`,
the number of people who have already applied, which is the most useful
competition signal on the listing.

`includePromoted` is kept in the input so existing saved configurations stay
valid, but it no longer does anything.

### 💰 How much does it cost?

You pay per job returned. Duplicates are removed before charging, so a listing Reed repeats across pages is charged once. Set `maxResults` to cap what a run can cost.

Runs that return nothing cost nothing. Paid Apify plans get a lower rate per job.

### 🔌 Integrations

Send results straight to Google Sheets, Slack, Airtable, Zapier, Make or your own webhook using [Apify integrations](https://docs.apify.com/platform/integrations). You can also trigger a run whenever something happens in another tool.

### 🔗 Using Reed Jobs Scraper with the Apify API

```bash
curl -X POST "https://api.apify.com/v2/acts/spookyweb~uk-jobs-reed/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": "warehouse", "location": "Manchester", "proximityMiles": 20, "maxResults": 100}'
```

Or with the Apify client:

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('spookyweb/uk-jobs-reed').call({
  keywords: 'warehouse',
  location: 'Manchester',
  proximityMiles: 20,
  maxResults: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

Full detail is in the [Apify API reference](https://docs.apify.com/api/v2), and every run is also callable from the [Python](https://docs.apify.com/api/client/python) and [JavaScript](https://docs.apify.com/api/client/js) clients.

### ❓ FAQ

#### Do I need my own Reed API key?

No, one is built in and the Actor works out of the box. There is an optional `reedApiKey` input if you would rather the requests ran against your own free key from [reed.co.uk/developers](https://www.reed.co.uk/developers).

#### How many jobs can I get from one search?

Up to 1000 per search, fetched in pages of 100, which is Reed's own API limit. Reed's headline match count is larger than the number of distinct jobs it will serve, so expect fewer unique rows than the site advertises. To cover more of a market, run several narrower searches split by town or by job title.

#### What does the applicant count tell me?

`applications` is how many people have already applied through Reed. It is the clearest competition signal on a listing: a role posted three days ago with 400 applications is a different proposition from one posted the same day with 4.

#### What is the difference between an employer and an agency listing?

`postedBy` says which. An Employer listing comes from the hiring organisation directly. A Recruitment agency listing is placed by an intermediary, and the same underlying vacancy can appear more than once through different agencies.

#### What does fetchDetails add?

The salary period, Reed's own annualised salary figures, the contract type, whether the role is full or part time, and the complete job description rather than a snippet. It costs one extra request per job. Turn it off when a title and a link are all you need.

#### Why use Reed's API rather than scraping the site?

Because the site cannot be paged. reed.co.uk accepts a `pageno` parameter and echoes it back, then serves the same 25 jobs for every page. A search Reed reported as 352 matches yielded 25 rows that way. The API returned all 304 of the same search.

### ⚖️ Is it legal to scrape Reed?

This uses Reed's official public API, the documented one Reed provides for exactly this purpose, rather than scraping their website. Job adverts are business information published by employers, not personal data about individuals.

Scraping publicly available data is legal in the UK, the EU and the US. If you go on to combine this data with personal data, that is on you to handle under GDPR. Apify's [ethical scraping guide](https://blog.apify.com/is-web-scraping-legal/) covers the wider picture.

### 👍 Your feedback

Found a bug, or want a field that is not here yet? Open an issue on the Actor's Issues tab. Requests that make the data more useful get built, and problems get fixed quickly.

### 🔎 You might also like

| Actor | What it does |
|---|---|
| [Indeed Jobs Scraper](https://apify.com/spookyweb/indeed-jobs) | Indeed listings with parsed salary figures, past the 15 job sign in wall |
| [LinkedIn Jobs Scraper](https://apify.com/spookyweb/linkedin-jobs) | LinkedIn jobs with company enrichment and CV keyword matching, no login needed |
| [Totaljobs Scraper](https://apify.com/spookyweb/uk-jobs-totaljobs) | UK jobs from Totaljobs with duplicate agency repostings removed |

# Actor input Schema

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

Job title or keywords, for example nurse or software developer.

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

Town, city or county, for example manchester or london.

## `proximityMiles` (type: `integer`):

Search radius in miles around the location. Reed measures this from the town or postcode given, so a wider radius pulls in neighbouring areas.

## `salaryFrom` (type: `integer`):

Lowest annual salary to accept, in GBP. Reed filters on the advertised range, so jobs that publish no salary are dropped when this is set.

## `salaryTo` (type: `integer`):

Highest annual salary to accept, in GBP. Reed filters on the advertised range, so jobs that publish no salary are dropped when this is set.

## `datePosted` (type: `string`):

Only return jobs posted within this window. Reed's API has no date filter, so this is applied to the results after they are fetched.

## `permanent` (type: `boolean`):

Include permanent roles. Leaving every contract type switched off returns all of them, so these switches narrow the search rather than widen it.

## `contract` (type: `boolean`):

Include fixed term contract roles. Leaving every contract type switched off returns all of them, so these switches narrow the search rather than widen it.

## `temporary` (type: `boolean`):

Include temporary roles. Leaving every contract type switched off returns all of them, so these switches narrow the search rather than widen it.

## `fullTime` (type: `boolean`):

Include full time roles. Combine with a contract type to narrow further, for example full time and permanent together.

## `partTime` (type: `boolean`):

Include part time roles. Combine with a contract type to narrow further, for example part time and temporary together.

## `graduate` (type: `boolean`):

Include roles Reed flags as suitable for graduates. These are a subset of the main listings rather than a separate job board.

## `includePromoted` (type: `boolean`):

Kept so existing saved inputs stay valid. Reed's API does not mark promoted listings, so this setting has no effect.

## `maxResults` (type: `integer`):

Hard cap on results. Each job is one billable result. Reed serves up to 1000 results per search through the API, in pages of 100.

## `reedApiKey` (type: `string`):

Leave blank to use the built in key. Supply your own free key from reed.co.uk/developers if you would rather run against your own account.

## `fetchDetails` (type: `boolean`):

On by default. Adds the salary period, Reed's own annualised salary, contract type, full or part time and the complete job description. Costs one extra fast request per job.

## Actor input object example

```json
{
  "keywords": "software developer",
  "location": "london",
  "proximityMiles": 10,
  "datePosted": "anytime",
  "permanent": false,
  "contract": false,
  "temporary": false,
  "fullTime": false,
  "partTime": false,
  "graduate": false,
  "includePromoted": false,
  "maxResults": 100,
  "fetchDetails": true
}
```

# Actor output Schema

## `results` (type: `string`):

One row per item: job listings with salary and applicant counts.

## `runSummary` (type: `string`):

Counts and stop reason for the run.

# 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 = {
    "keywords": "software developer",
    "location": "london"
};

// Run the Actor and wait for it to finish
const run = await client.actor("spookyweb/uk-jobs-reed").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 = {
    "keywords": "software developer",
    "location": "london",
}

# Run the Actor and wait for it to finish
run = client.actor("spookyweb/uk-jobs-reed").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 '{
  "keywords": "software developer",
  "location": "london"
}' |
apify call spookyweb/uk-jobs-reed --silent --output-dataset

```

## MCP server setup

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

```

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/4iavHborUyvW5vQgz/builds/rtwg1A1ZvA5msN9dc/openapi.json