# Reed.co.uk Jobs Scraper (`fetch_cat/reed-co-uk-jobs-scraper`) Actor Scrape public Reed.co.uk job listings by keyword, location, salary, job type, and posted date. Export clean job data for recruiting analysis. - **URL**: https://apify.com/fetch\_cat/reed-co-uk-jobs-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.05 / 1,000 result extracteds 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Search and export public UK job listings from Reed.co.uk by keyword, location, job type, date posted, or Reed search URL. Use this Actor to collect structured Reed.co.uk job data for recruiting research, lead generation, UK labor-market analysis, salary tracking, job-board workflows, and internal dashboards. Results can be downloaded as CSV, JSON, Excel, XML, RSS, or used through the Apify Dataset API. ### At a glance - **UK job search**: Search Reed.co.uk by job title, skill, keyword, location, radius, job type, and posting freshness. - **Search URL reuse**: Paste a Reed.co.uk search URL when you already built the right search in the browser. - **Structured rows**: Export titles, companies, locations, salary text, job type, posting date, Reed job ID, and job URL. - **Description control**: Include full description text when you need richer analysis, or keep runs lighter with snippets. - **API export**: Send Reed job rows to spreadsheets, CRMs, BI tools, job boards, monitoring workflows, or AI agents. ### Ready-to-run examples Use these saved Store examples as starting points. Open any example to prefill the Actor input, then adjust URLs, keywords, limits, or filters for your own run. - **[Scrape a Reed software jobs search URL](https://apify.com/fetch_cat/reed-co-uk-jobs-scraper/examples/scrape-reed-start-url-software-jobs)** - **[Capture full descriptions for product manager jobs](https://apify.com/fetch_cat/reed-co-uk-jobs-scraper/examples/capture-full-description-product-manager-jobs)** - **[Scrape marketing manager jobs in London](https://apify.com/fetch_cat/reed-co-uk-jobs-scraper/examples/scrape-marketing-manager-jobs-london)** - **[Collect graduate jobs across the UK](https://apify.com/fetch_cat/reed-co-uk-jobs-scraper/examples/collect-graduate-jobs-uk)** - **[Research sales jobs in Leeds](https://apify.com/fetch_cat/reed-co-uk-jobs-scraper/examples/research-sales-jobs-leeds)** - **[Export part-time retail jobs in London](https://apify.com/fetch_cat/reed-co-uk-jobs-scraper/examples/export-part-time-retail-jobs-london)** - **[View all ready-to-run examples](https://apify.com/fetch_cat/reed-co-uk-jobs-scraper/examples)** (12 examples) ### What can it do? Reed.co.uk Jobs Scraper turns public Reed job-search results into structured dataset rows. - **Search UK roles**: Enter one or more job titles, skills, or keywords. - **Filter by location**: Add a UK location and search radius for regional monitoring. - **Filter by job type**: Keep permanent, temporary, contract, part-time, or full-time listings. - **Track freshness**: Limit keyword searches by date posted when Reed supports the filter. - **Collect canonical URLs**: Save Reed job IDs and job URLs for follow-up research and deduplication. ### Common workflows - **Recruiting research**: Build lists of active openings by title, skill, location, employer, or recruiter. - **Sales lead generation**: Find companies currently hiring for target roles and prioritize account outreach. - **Salary monitoring**: Track visible salary ranges for specific job titles or UK regions. - **Regional market analysis**: Compare hiring demand across cities, regions, or remote searches. - **Job-board benchmarking**: Export listing metadata for market research or category analysis. - **Dashboard feeds**: Schedule repeat searches and send results to BI tools or spreadsheets. ### What data can you extract? The Actor returns one dataset row per public Reed.co.uk job listing. | Field | Description | | --- | --- | | `title` | Job title | | `companyName` | Hiring company or recruiter name | | `location` | Displayed job location | | `salary` | Salary text or range when available | | `jobType` | Job type signals such as full-time, permanent, or contract | | `postedAt` | Posted/display date from Reed | | `descriptionSnippet` | Short description preview | | `descriptionText` | Full description when enabled | | `jobUrl` | Reed job detail URL | | `reedJobId` | Reed job identifier | | `sourceQuery` | Query that produced the listing when applicable | | `scrapedAt` | Timestamp of extraction | ### Pricing The Actor uses pay-per-event pricing, so cost is tied to the run and the number of saved job rows. | Event | Price | Charged when | | --- | --- | --- | | Run start | `$0.005` per run | Once when the Actor starts. | | Reed job result | BRONZE `$0.00005` per saved job row | Each Reed.co.uk listing saved to the dataset. This is about `$0.05` per 1,000 saved jobs on BRONZE. | Use a low `maxItems` value for the first run, review the dataset, and then scale up. Exact live pricing is shown on the Apify Actor page before you start a run. ### Input configuration | Setting | JSON key | Use it for | Example | | --- | --- | --- | --- | | Search queries | `queries` | Job titles, skills, or keywords to search on Reed.co.uk. | `["software developer"]` | | Reed search URLs | `startUrls` | Reed.co.uk search URLs to scrape in addition to keyword searches. | `[{"url":"https://www.reed.co.uk/jobs/software-developer-jobs"}]` | | Location | `location` | Optional UK location for keyword searches. | `London` | | Radius | `radius` | Search radius in miles around the selected location. | `10` | | Date posted | `datePosted` | Limit keyword searches by posting date. | `last7days` | | Job type | `jobType` | Filter by permanent, temporary, contract, part-time, or full-time listings. | `contract` | | Include full description | `includeDetails` | Add full description text when available. | `false` | | Maximum jobs | `maxItems` | Cap saved job rows and spend. | `25` | ### Example input ```json { "queries": ["software developer"], "location": "London", "radius": 10, "datePosted": "all", "jobType": "all", "includeDetails": false, "maxItems": 25 } ```` ### Example output ```json { "title": "Software Developer", "companyName": "Example Recruiter", "location": "London", "salary": "£45,000 - £65,000", "jobType": "Full-time, Permanent", "postedAt": "2026-06-09T16:11:30.287", "descriptionSnippet": "Our client is seeking an experienced Software Developer...", "jobUrl": "https://www.reed.co.uk/jobs/software-developer/57002409", "reedJobId": "57002409", "sourceQuery": "software developer", "scrapedAt": "2026-06-29T10:00:00.000Z" } ``` ### How to run it 1. Open the Actor on Apify. 2. Enter one or more search queries or Reed search URLs. 3. Add an optional UK location, radius, date-posted filter, or job-type filter. 4. Set `maxItems` to the number of listings you want to save. 5. Choose whether to include full descriptions. 6. Start the run and export the dataset. ### Search tips - **Use clear role names**: `software developer`, `finance manager`, or `customer success` usually works better than one broad word. - **Compare locations separately**: Run one city or region per input when you need clean comparisons. - **Reuse browser searches**: Paste `startUrls` when you have already configured a Reed search manually. - **Control spend**: Keep `maxItems` small while testing and increase it after checking the result quality. - **Enable details selectively**: Full descriptions are useful for keyword analysis, but snippets are faster for simple company/title lists. ### Limits and caveats - The Actor extracts publicly visible Reed.co.uk job-search data. - It does not access private employer dashboards, applicant data, or login-gated recruiter tools. - Salary and company fields are empty when Reed does not show them for a listing. - Reed search filters can change, so validate important scheduled searches after changing input settings. ### Integrations You can connect Reed job data to downstream tools: - Export CSV or Excel to spreadsheets for weekly recruiting reports. - Send hiring-company lists to a CRM for sales or account research. - Load JSON rows into BI tools such as Looker Studio, Power BI, or Tableau. - Trigger Slack, email, or webhook alerts after scheduled runs. - Combine Reed outputs with ATS and remote-job scrapers for broader market coverage. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/reed-co-uk-jobs-scraper').call({ queries: ['software developer'], location: 'London', maxItems: 25 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('fetch_cat/reed-co-uk-jobs-scraper').call(run_input={ 'queries': ['software developer'], 'location': 'London', 'maxItems': 25, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~reed-co-uk-jobs-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"queries":["software developer"],"location":"London","maxItems":25}' ``` ### MCP and AI agents This Actor can be used through the official Apify MCP server at `https://mcp.apify.com`. For a focused single-Actor tool setup, use: ```text https://mcp.apify.com?tools=fetch_cat/reed-co-uk-jobs-scraper ``` Use the same JSON keys shown in the input configuration table, such as `queries`, `startUrls`, `location`, `radius`, `jobType`, `includeDetails`, and `maxItems`. ### FAQ #### Can I use this as a Reed.co.uk jobs API? Yes. You can run the Actor through the Apify API and read results from the Dataset API. #### Can I export Reed.co.uk jobs to CSV or Excel? Yes. Apify datasets can be downloaded as CSV, JSON, Excel, XML, RSS, HTML, or accessed through the API. #### Why is salary empty? Some Reed.co.uk listings do not publish salary text or use hidden salary settings. #### Why did I get fewer jobs than `maxItems`? The search may have fewer matching public listings, or filters such as location, date, or job type may be too strict. ### Related scrapers - [LinkedIn Jobs Scraper](https://apify.com/fetch_cat/linkedin-jobs-scraper) - [RemoteOK Jobs Scraper](https://apify.com/fetch_cat/remoteok-jobs-scraper) - [Remotive Jobs Scraper](https://apify.com/fetch_cat/remotive-jobs-scraper) - [Greenhouse Job Board Scraper](https://apify.com/fetch_cat/greenhouse-jobs-scraper) - [Workday Jobs Scraper](https://apify.com/fetch_cat/workday-jobs-scraper) ### Changelog #### 0.1 - Initial public release with keyword, search URL, location, radius, date, job-type, description, and maximum-result controls for public Reed.co.uk listings. ### Support If a run fails, returns no data, or a field looks wrong, open an issue from the Actor page. Please include the Apify run ID or run URL, input JSON, one example public URL, query, or input item, what you expected, and what the dataset returned. Small reproducible inputs make parsing or site-layout issues much faster to fix. # Actor input Schema ## `queries` (type: `array`): Job titles, skills, or keywords to search on Reed.co.uk. ## `startUrls` (type: `array`): Optional Reed.co.uk job search URLs to scrape instead of, or in addition to, keyword searches. ## `location` (type: `string`): Optional UK location used with keyword searches, e.g. London, Manchester, Birmingham, Remote. ## `radius` (type: `integer`): Search radius around the selected location. ## `datePosted` (type: `string`): Limit keyword searches by posting date when supported by Reed. ## `jobType` (type: `string`): Optional job type filter for keyword searches. ## `includeDetails` (type: `boolean`): Add the full job description text from the search payload. Keep disabled for smaller exports. ## `maxItems` (type: `integer`): Maximum number of job listings to save across all queries and URLs. ## Actor input object example ```json { "queries": [ "software developer" ], "startUrls": [ { "url": "https://www.reed.co.uk/jobs/software-developer-jobs" } ], "location": "London", "radius": 10, "datePosted": "all", "jobType": "all", "includeDetails": false, "maxItems": 20 } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "software developer" ], "startUrls": [ { "url": "https://www.reed.co.uk/jobs/software-developer-jobs" } ], "location": "London" }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/reed-co-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["software developer"], "startUrls": [{ "url": "https://www.reed.co.uk/jobs/software-developer-jobs" }], "location": "London", } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/reed-co-uk-jobs-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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" ], "startUrls": [ { "url": "https://www.reed.co.uk/jobs/software-developer-jobs" } ], "location": "London" }' | apify call fetch_cat/reed-co-uk-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/reed-co-uk-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reed.co.uk Jobs Scraper", "description": "Scrape public Reed.co.uk job listings by keyword, location, salary, job type, and posted date. Export clean job data for recruiting analysis.", "version": "0.1", "x-build-id": "ICQ1mQKFnviB8eDvq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~reed-co-uk-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-reed-co-uk-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fetch_cat~reed-co-uk-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-reed-co-uk-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fetch_cat~reed-co-uk-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-reed-co-uk-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "queries": { "title": "Search queries", "type": "array", "description": "Job titles, skills, or keywords to search on Reed.co.uk.", "items": { "type": "string" } }, "startUrls": { "title": "Reed search URLs", "type": "array", "description": "Optional Reed.co.uk job search URLs to scrape instead of, or in addition to, keyword searches.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "type": "string", "description": "Optional UK location used with keyword searches, e.g. London, Manchester, Birmingham, Remote." }, "radius": { "title": "Radius (miles)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Search radius around the selected location.", "default": 10 }, "datePosted": { "title": "Date posted", "enum": [ "all", "today", "last3days", "last7days", "last14days", "last30days" ], "type": "string", "description": "Limit keyword searches by posting date when supported by Reed.", "default": "all" }, "jobType": { "title": "Job type", "enum": [ "all", "permanent", "temporary", "contract", "partTime", "fullTime" ], "type": "string", "description": "Optional job type filter for keyword searches.", "default": "all" }, "includeDetails": { "title": "Include full description", "type": "boolean", "description": "Add the full job description text from the search payload. Keep disabled for smaller exports.", "default": false }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job listings to save across all queries and URLs.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```