# Reed.co.uk Jobs Scraper (`solidcode/reed-co-uk-scraper`) Actor \[๐Ÿ’ฐ $0.95 / 1K] Extract UK job listings from Reed.co.uk by keyword, location, salary, contract type, and posted-by source. Get titles, companies, salaries, descriptions, employment types, posted dates, and direct apply URLs โ€” every row a flat job posting. - **URL**: https://apify.com/solidcode/reed-co-uk-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 6 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.95 / 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? 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 Jobs Scraper Pull live UK job listings from Reed.co.uk at scale โ€” titles, hiring company, salary parsed into min/max/currency/period, location, employment-type flags, posted date, the full job description, recruiter name, sector, and direct apply URLs. Built for UK recruiters, salary-benchmark analysts, and HR-tech sales teams who need a clean Reed feed without writing scrapers. ### Why This Scraper? - **Every Reed-native filter wired through** โ€” 5 employment-type toggles (permanent, contract, temp, full-time, part-time), agency vs. direct-employer source filter, 7 distance bands (exact location to 40 miles), 5 date-posted windows (today / last 3 days / last week / last 2 weeks / any), and GBP min/max salary range โ€” none of which the multi-board aggregators expose. - **Salary parsed into structured fields** โ€” every row carries `salaryMin`, `salaryMax`, `salaryCurrency` as an ISO code, and `salaryPeriod` (annual / hourly / daily / weekly / monthly) alongside the original Reed text. Overseas postings keep their real currency (EUR, USD, AED, INR, CAD, JPY, AUD, PLN, HUF), so a โ‚ฌ90,000 role is never mistaken for a ยฃ90,000 one. No custom regex on your end to filter "ยฃ40-60k" candidates. - **Up to 5,000 jobs per run** โ€” pagination handled automatically; works equally well at 50 rows for a quick lead pull or 5,000 rows for a region-wide salary survey. - **Free-form keyword + UK location** โ€” no preset role lists, no fixed locations. Type `"data engineer"` + `"se1"` (postcode) or `"warehouse operative"` + `"manchester"` and Reed's own geocoder handles the rest. - **The full job description on every row, no toggle required** โ€” `description` carries the complete posting body as plain text on every standard run, not a truncated preview. The optional enrichment pass adds exactly three extras on top: `descriptionHtml` (the same text with its original formatting), `sector` (Reed's own category), and `recruiterReedProfileUrl` for the recruiters Reed publishes a page for. - **Accepts pasted Reed URLs** โ€” drop in a search-results URL straight from the Reed website (sector picker, graduate, easy-apply, and visa-sponsorship flags all carry through) or an individual job-detail URL โ€” both work side-by-side with free-text queries in the same run. - **Per-row search echo** โ€” every row records the `searchKeywords` and `searchLocation` that produced it, so multi-query batch runs stay filterable downstream in CSV / Excel / Postgres. - **No login. No API key. No setup.** Enter a keyword and a UK city and you have a clean dataset in minutes. ### Use Cases **Recruitment Lead Generation** - Build target lists of recruitment agencies actively advertising in your sector, named on every row - Identify direct employers hiring for the same role you place candidates into - Track which agencies dominate a given UK region or job category - Turn on detail enrichment to add a Reed company-profile link for the recruiters who publish one, so you can jump straight from a lead to their live vacancy list **Salary Benchmarking** - Live UK pay data by role, region, and seniority, refreshed on demand - Compare permanent vs. contract day-rates for the same job title - Surface salary-band shifts week-on-week for compensation reviews **Job-Aggregator & White-Label Boards** - Backfill a niche or regional jobs board with curated Reed listings - Power a Slack/email alerting product for new roles in a specific stack - Build a sector-specific newsletter (FinTech London, NHS healthcare, etc.) **Workforce & Skills Market Research** - Track demand for skills like "Python", "AWS", "Salesforce" by region over time - Map remote vs. hybrid vs. on-site mix in your industry - Quantify graduate, contract, and permanent supply per UK city **Competitive Intelligence for HR-Tech Sales** - Identify recruitment agencies as warm leads for ATS, CRM, or sourcing tools - Track which competitors of your target customer are hiring (and for what) - Monitor hiring spikes to time outbound campaigns ### Getting Started #### Basic Search A single keyword + city โ€” fastest path to a useful dataset: ```json { "keywords": "python developer", "location": "london" } ``` #### Filtered Search Narrow to fixed-term contract data engineers in Manchester within 20 miles, paying ยฃ60k+: ```json { "keywords": "data engineer", "location": "manchester", "distance": "20", "permanent": false, "contract": true, "temp": false, "minSalary": 60000, "maxResults": 200 } ``` #### URL List with Detail Enrichment Mix two pre-filtered Reed search URLs and add formatted descriptions, sector, and recruiter profile links to both: ```json { "urls": [ "https://www.reed.co.uk/jobs/python-jobs-in-bristol", "https://www.reed.co.uk/jobs/devops-jobs-in-edinburgh" ], "fetchDescription": true, "maxResults": 500 } ``` ### Input Reference #### Search | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `keywords` | string | `"python developer"` | Job title or skill to search, such as `"python developer"` or `"marketing manager"`. Leave empty to scrape Reed's general listing. | | `location` | string | `"london"` | UK city, region, or postcode (e.g., `"london"`, `"manchester"`, `"se1"`, `"remote"`). Reed accepts full or partial postcodes and town names. | | `distance` | select | `10 miles` | Search radius from the location: `Exact location only`, `5 miles`, `10 miles`, `15 miles`, `20 miles`, `30 miles`, `40 miles`. Ignored when location is empty. | | `urls` | string\[] | `[]` | Optional. Paste Reed.co.uk search URLs or individual job URLs. Filters baked into pasted URLs are honored as-is. | #### Job Type A single posting can carry multiple flags (e.g., a role can be both contract AND full-time). Each toggle includes any role tagged with that flag. | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `permanent` | boolean | `true` | Include permanent contract roles. | | `contract` | boolean | `true` | Include fixed-term contract roles. | | `temp` | boolean | `true` | Include temporary roles. | | `fullTime` | boolean | `true` | Include full-time roles. | | `partTime` | boolean | `false` | Include part-time roles. | #### Salary | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `minSalary` | integer | null | Minimum annual salary in GBP. Many Reed listings are tagged `"Competitive"` and may be excluded by Reed's server-side filter when set. | | `maxSalary` | integer | null | Maximum annual salary in GBP. | #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `postedBy` | select | `Any (agency or direct employer)` | Filter by who listed the role: `Any (agency or direct employer)`, `Recruitment agency only`, or `Direct employer only`. | | `datePosted` | select | `Any time` | Only show roles posted within this window: `Any time`, `Today`, `Last 3 days`, `Last week`, `Last 2 weeks`. | #### Advanced | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `fetchDescription` | boolean | `false` | Off by default. Adds three fields to every row: `descriptionHtml`, `sector`, and `recruiterReedProfileUrl`. It does **not** control `description` โ€” the full plain-text posting body is already on every row without it. Enrichment opens each posting individually, so runs take substantially longer; the per-result price is the same either way. | | `maxResults` | integer | `100` | Cap on total job rows across all keywords and URLs. Hard upper bound is 5,000 โ€” set to `0` to use that cap directly. The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots (up to ~100 results per page). | ### Output Every row is a flat job posting. Here is a representative result: ```json { "jobId": "56626200", "title": "Python Developer - Insurance Analytics", "company": "McGregor Boyall", "location": "London", "salary": "ยฃ40,000 - ยฃ60,000 per annum", "salaryMin": 40000, "salaryMax": 60000, "salaryCurrency": "GBP", "salaryPeriod": "annual", "employmentType": ["Permanent", "Full-time"], "postedBy": "agency", "postedDate": "2026-04-28T10:27:23", "expiryDate": "2026-06-09T23:55:00", "applyUrl": "https://www.reed.co.uk/jobs/python-developer-insurance-analytics/56626200/apply", "jobUrl": "https://www.reed.co.uk/jobs/python-developer-insurance-analytics/56626200", "snippet": "We are looking for a Python developer to join our insurance analytics team...", "description": "We are looking for a Python developer to join our insurance analytics team. You will be working on...", "descriptionHtml": "

We are looking for a Python developer...

", "sector": "IT & Telecoms", "recruiterName": "McGregor Boyall", "recruiterReedProfileUrl": "https://www.reed.co.uk/company-profile/McGregor-Boyall-49265", "searchKeywords": "python developer", "searchLocation": "london", "scrapedAt": "2026-05-09T14:30:00Z" } ``` #### Core Fields | Field | Type | Description | |-------|------|-------------| | `jobId` | string | Reed's numeric job identifier. | | `title` | string | Job title as posted. | | `company` | string | null | Hiring company name. May be null when posted by an agency anonymously. | | `location` | string | Location as Reed displays it (e.g., `"London"`, `"Manchester ยท Remote"`). | | `snippet` | string | Short preview always present from the search results card. | | `postedDate` | string | When the role was posted (ISO 8601). | | `expiryDate` | string | null | When the listing closes (ISO 8601). | #### Salary | Field | Type | Description | |-------|------|-------------| | `salary` | string | null | Salary text as posted (e.g., `"ยฃ45,000 - ยฃ55,000 per annum"`, `"ยฃ18 per hour"`, `"Competitive"`). | | `salaryMin` | number | null | Parsed minimum salary. Null when not parseable. | | `salaryMax` | number | null | Parsed maximum salary. Null when not parseable. | | `salaryCurrency` | string | null | ISO currency code. `"GBP"` on the overwhelming majority of rows; overseas listings return their own code (`EUR`, `USD`, `AED`, `INR`, `CAD`, `JPY`, `AUD`, `PLN`, `HUF`). Null only when Reed reports a currency we cannot identify, in which case `salary` omits the symbol rather than guessing. | | `salaryPeriod` | string | null | `"annual"`, `"monthly"`, `"weekly"`, `"daily"`, `"hourly"`, or null. | #### Employment & Source | Field | Type | Description | |-------|------|-------------| | `employmentType` | string\[] | Subset of `["Permanent", "Contract", "Temporary", "Full-time", "Part-time"]`. | | `postedBy` | string | null | `"agency"` or `"directEmployer"`. | | `sector` | string | null | Reed's sector category (e.g., `"IT & Telecoms"`, `"Healthcare"`). Enrichment runs only (`fetchDescription: true`); `null` otherwise. | | `recruiterName` | string | null | Recruiter or company name on the listing page. On every row. | | `recruiterReedProfileUrl` | string | null | Link to the recruiter's Reed company profile. Enrichment runs only (`fetchDescription: true`), and only for recruiters who have a Reed company profile; `null` otherwise. | #### Description & Links | Field | Type | Description | |-------|------|-------------| | `description` | string | null | Full job description as plain text. Populated on every row, whether or not `fetchDescription` is on. | | `descriptionHtml` | string | null | The same description with its original markup preserved (`

`, `