# Reed.co.uk Jobs Scraper: UK Jobs with Salaries (`scrapemint/reed-jobs-scraper`) Actor

UK jobs from reed.co.uk for any keyword and location: salary range and period, company, job type, remote or hybrid, posted and expiry dates, apply link. Optional full description, skills and postcode. Filters by salary, job type, date and employer. $0.001 per job.

- **URL**: https://apify.com/scrapemint/reed-jobs-scraper.md
- **Developed by:** [Ken M](https://apify.com/scrapemint) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 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.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Reed.co.uk Jobs Scraper: UK Jobs with Salaries

Job listings from **reed.co.uk**, one of the UK's biggest job boards, as clean rows: title, company, location and county, **salary range and period** (per annum, per day, per hour), **permanent, contract or temporary**, full or part time, **remote, hybrid or on-site**, posted and expiry dates, category, Easy Apply flag and a description snippet.

Turn on **Full description and skills** and every job also gets the full description, the skills list, postcode, region, sector, the salary converted to per annum and the recruiter's reference.

Search by keyword and location, or paste a Reed search URL. Reed lets you page to the end of every search, so there is no 1,000-job cap.

No Reed account, no API key, no proxy. $0.001 per job, no start fee.

### What you get per job

- `jobId`, `url`, `title`
- `companyName`, `companyReedUrl`, `companyLogoUrl`
- `location`, `county`, `workingOption` (remote, hybrid, onSite)
- `jobType` (Permanent, Contract, Temporary), `isFullTime`, `isPartTime`
- `salaryFrom`, `salaryTo`, `salaryCurrency`, `salaryPeriod`, `salaryNotes` (OTE, inc benefits, pro-rata, negotiable, competitive)
- `postedAt`, `createdAt`, `updatedAt`, `expiresAt`
- `category`, `occupation`, `isEasyApply`, `externalApplyUrl`, `isPromoted`, `isTrainingJob`, `ukOnly`, `snippet`

With **Full description and skills** on:

- `descriptionText`, `descriptionHtml`, `skills`
- `salaryText`, `salaryFromPerAnnum`, `salaryToPerAnnum`
- `contractType`, `sector`, `parentSector`
- `town`, `region`, `postcode`, `country`, `isRemote`, `locationType`
- `recruiterType` (agency or employer), `recruiterReference`, `isGraduate`

### Example input

Python developers within 20 miles of Manchester, posted in the last week:

```json
{
  "queries": ["python developer"],
  "location": "Manchester",
  "distanceMiles": 20,
  "postedWithin": "lastweek"
}
```

Remote contract roles over £50,000, from direct employers, with full descriptions:

```json
{
  "queries": ["data engineer", "devops engineer"],
  "jobTypes": ["contract"],
  "workingOption": "remote",
  "salaryFrom": 50000,
  "employerType": "direct",
  "includeDetails": true,
  "maxItemsPerSearch": 500
}
```

A search URL copied from reed.co.uk:

```json
{
  "searchUrls": ["https://www.reed.co.uk/jobs/nurse-jobs-in-london?proximity=5"]
}
```

### Example output

```json
{
  "jobId": 57411163,
  "url": "https://www.reed.co.uk/jobs/principal-software-engineer/57411163",
  "title": "Principal Software Engineer",
  "companyName": "Matchtech",
  "location": "Stockport",
  "county": "Cheshire",
  "workingOption": "hybrid",
  "jobType": "Permanent",
  "salaryFrom": 75000,
  "salaryTo": 90000,
  "salaryCurrency": "GBP",
  "salaryPeriod": "per annum",
  "postedAt": "2026-10-01T10:38:34.63",
  "expiresAt": "2026-11-12T23:55:00",
  "category": "Engineer",
  "occupation": "Principal Engineer",
  "isEasyApply": true,
  "skills": ["Java & Microservices"],
  "region": "North West England",
  "parentSector": "IT & Telecoms",
  "recruiterType": "agency",
  "descriptionText": "Our client, a leading UK insurance and technology organisation, is seeking a Principal Software Engineer ..."
}
```

### Uses

- **Recruiters and agencies:** who is hiring for which roles across the UK, with salary bands and the hiring company
- **Salary benchmarking:** salary ranges by role, town and job type, with per-day and per-hour rates converted to per annum
- **Sales and lead generation:** companies hiring in your target sector are companies with budget; filter to direct employers
- **Job boards and aggregators:** a clean UK job feed with full descriptions
- **Labour-market analysis:** remote vs on-site, contract vs permanent, by sector, over time with scheduled runs

### Pricing

- **$0.001** per job from the search results
- **$0.002** per job with **Full description and skills** on (charged instead of the $0.001, not on top)
- No start fee. A search with no results is free.

### Notes

- Reed has no sort option: results come in Reed's own order. To collect new jobs, schedule a run with **Posted within: Today** or **Last 3 days**.
- Salary filters are per year; Reed applies them to its own annualised figure.
- A job that appears in two of your searches is kept once.
- `salaryPeriod` and `jobType` are left empty for the rare codes not yet mapped, rather than guessed.

# Actor input Schema

## `queries` (type: `array`):

One search per keyword or job title, e.g. python developer, nurse, accountant, warehouse operative.

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

Optional town, city, county or postcode, e.g. London, Manchester, Kent, LS1. Empty searches the whole UK.

## `distanceMiles` (type: `integer`):

Optional radius around the location: 0, 1, 3, 5, 10, 15, 20, 30 or 50. Reed's default is 10.

## `searchUrls` (type: `array`):

Search pages copied from reed.co.uk/jobs with your filters already set. Filters below do not apply to these.

## `jobTypes` (type: `array`):

Any of: permanent, contract, temporary, full_time, part_time. Empty keeps all.

## `workingOption` (type: `string`):

Keep only remote, hybrid or on-site jobs.

## `postedWithin` (type: `string`):

Only jobs posted in this window. Use Today or Last 3 days on a schedule to collect new jobs.

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

Optional, e.g. 30000.

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

Optional, e.g. 60000.

## `employerType` (type: `string`):

Keep jobs posted by direct employers, or by recruitment agencies.

## `graduateOnly` (type: `boolean`):

Keep only jobs Reed marks as suitable for graduates.

## `hideTrainingJobs` (type: `boolean`):

Drop training-course listings that Reed shows among jobs.

## `includeDetails` (type: `boolean`):

Reads each job page for the full description, skills, postcode, region, sector, salary per annum and recruiter reference. Costs $0.002 per job instead of $0.001.

## `maxItemsPerSearch` (type: `integer`):

Stop each search after this many jobs. Reed shows 25 per page and lets you page to the end of every search.

## Actor input object example

```json
{
  "queries": [
    "software developer"
  ],
  "location": "",
  "searchUrls": [],
  "jobTypes": [],
  "workingOption": "",
  "postedWithin": "anytime",
  "employerType": "any",
  "graduateOnly": false,
  "hideTrainingJobs": false,
  "includeDetails": false,
  "maxItemsPerSearch": 200
}
```

# Actor output Schema

## `jobs` (type: `string`):

Title, company, location, job type, salary, remote option, dates, and with details on the full description and skills.

## `summary` (type: `string`):

Jobs on Reed and jobs saved per search, and any searches that failed.

# 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 = {
    "queries": [
        "software developer"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapemint/reed-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 = { "queries": ["software developer"] }

# Run the Actor and wait for it to finish
run = client.actor("scrapemint/reed-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 '{
  "queries": [
    "software developer"
  ]
}' |
apify call scrapemint/reed-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapemint/reed-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/cxOAkt8Wg46e7A0ui/builds/ooTwSEraLMKFhObgG/openapi.json