# Reed.co.uk Jobs Scraper (`manfromgold/reed-co-uk-scraper`) Actor

Scrape UK job postings from Reed.co.uk by keyword, location and contract type. Each job includes title, employer, parsed salary range and period, location, contract and working hours, workplace type and posted date, for recruitment and salary benchmarking.

- **URL**: https://apify.com/manfromgold/reed-co-uk-scraper.md
- **Developed by:** [Mahmoud Dahab](https://apify.com/manfromgold) (community)
- **Categories:** Jobs, Lead generation, Business
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 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/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

Scrape UK job postings from Reed.co.uk by keyword, location and contract type. Each job includes title, employer, parsed salary range and period, location, contract and working hours, workplace type and posted date, for recruitment and salary benchmarking.

### What data does Reed.co.uk Jobs Scraper extract?

| Field | Description |
|---|---|
| `jobId` | Reed job ID |
| `title` | Job title |
| `url` | Absolute URL of the job detail page |
| `employer` | Hiring company or recruitment agency |
| `location` | Job location as shown on Reed |
| `salaryText` | Raw salary text, e.g. '£33,000 per annum' or 'Competitive salary' |
| `salaryMin` | Lower bound of the salary in GBP |
| `salaryMax` | Upper bound of the salary in GBP |
| `salaryPeriod` | Salary period: hour, day, week, month or annum |
| `contractType` | Contract type, e.g. Permanent, Contract, Temporary |
| `workingHours` | Working hours, e.g. full-time, part-time, full-time or part-time |
| `workplaceType` | On-site, Hybrid or Remote when stated |
| `postedDate` | Posting date as an ISO 8601 date, estimated from relative text such as '1 hr ago' |
| `badges` | Listing badges such as Promoted, Featured, New, Easy Apply |
| `description` | Job description snippet. Filled only when the page includes embedded job data; otherwise empty. |

### Use cases

- Benchmark hourly and annual salaries for a role across UK regions
- Monitor which employers and agencies are hiring most actively in a sector
- Feed fresh UK vacancies into a recruitment agency's CRM for business development
- Track the mix of permanent, contract and temporary roles over time
- Analyse hybrid, remote and on-site work trends in UK job postings

### How to use it

1. Fill in the input fields (or keep the prefilled example).
2. Set **Max results** to cap the run size and cost.
3. Click **Start** and download results as JSON, CSV, Excel or via the API.

#### Input

| Input | Description |
|---|---|
| `keywords` | Job title, skill or keyword to search for (e.g. 'data analyst'). Leave empty to get all jobs. |
| `location` | UK town, county or region (e.g. 'London', 'Manchester'). Leave empty for the whole UK. |
| `jobType` | Only return jobs with this contract type. The filter is passed to Reed as a query parameter. |
| `maxItems` | Maximum number of results. |
| `maxPages` | Maximum number of pages to load. |

### Output example

```json
[
  {
    "jobId": "57427554",
    "title": "Management Accountant - Fintech",
    "url": "https://www.reed.co.uk/jobs/management-accountant-fintech/57427554",
    "employer": "Absolute Recruit",
    "location": "London",
    "salaryText": "£45,000 - £55,000 per annum",
    "salaryMin": 45000,
    "salaryMax": 55000,
    "salaryPeriod": "annum",
    "contractType": "Permanent",
    "workingHours": "full-time",
    "workplaceType": "Hybrid",
    "postedDate": "2026-10-06",
    "badges": [
      "Easy Apply"
    ],
    "description": null
  },
  {
    "jobId": "57303450",
    "title": "Senior Management Accountant",
    "url": "https://www.reed.co.uk/jobs/senior-management-accountant/57303450",
    "employer": "TPH Global",
    "location": "Twickenham, Middlesex",
    "salaryText": "Competitive salary",
    "salaryMin": null,
    "salaryMax": null,
    "salaryPeriod": null,
    "contractType": "Permanent",
    "workingHours": "full-time",
    "workplaceType": "Hybrid",
    "postedDate": "2026-09-21",
    "badges": [],
    "description": null
  }
]
```

### Pricing

Pay per result: **$2.00 per 1,000 results**. Platform usage is included. Runs stop at **Max results**, so cost is predictable.

### Is it legal to scrape this site?

This Actor extracts only publicly available, non-personal information from reed.co.uk. It does not log in or bypass access controls. Make sure your use of the data complies with the site's terms and the laws that apply to you.

### Reliability

This Actor is checked automatically several times a day. When the website changes its layout, the extractor is repaired and re-tested against the same output fields, so your integrations keep working.

# Actor input Schema

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

Job title, skill or keyword to search for (e.g. 'data analyst'). Leave empty to get all jobs.

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

UK town, county or region (e.g. 'London', 'Manchester'). Leave empty for the whole UK.

## `jobType` (type: `string`):

Only return jobs with this contract type. The filter is passed to Reed as a query parameter.

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

Stop after this many results. You are charged per result, so this also caps the cost.

## `maxPages` (type: `integer`):

Maximum number of pages to load (listing pages and pagination).

## `proxyConfiguration` (type: `object`):

Proxies help avoid blocking. Datacenter proxies are enough for most runs.

## `debugSaveHtml` (type: `boolean`):

Store the HTML of the first pages in the key-value store, for troubleshooting.

## Actor input object example

```json
{
  "keywords": "accountant",
  "location": "London",
  "jobType": "any",
  "maxItems": 100,
  "maxPages": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "debugSaveHtml": false
}
```

# Actor output Schema

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

Records extracted from reed.co.uk, one dataset item each.

# 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": "accountant",
    "location": "London",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

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

# Prepare the Actor input
run_input = {
    "keywords": "accountant",
    "location": "London",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("manfromgold/reed-co-uk-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 '{
  "keywords": "accountant",
  "location": "London",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call manfromgold/reed-co-uk-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,manfromgold/reed-co-uk-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/9iYeI55hVnTHqUMHm/builds/1hMt5S4vOZtqMLfRw/openapi.json