# Reed Jobs Scraper | UK Job Listings & Hiring Data (`b2b_leads/reed-jobs-real-time-data`) Actor Reed jobs scraper, UK jobs, hiring data, job listings, recruiters, staffing, remote jobs, London, structured JSON, job board, market research, CRM, webhook, AI/LLM, real-time, Apify actor. - **URL**: https://apify.com/b2b\_leads/reed-jobs-real-time-data.md - **Developed by:** [Chidubem Aneke](https://apify.com/b2b_leads) (community) - **Categories:** Jobs, Developer tools, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $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/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 Jobs Real-Time Data **The fastest way to collect Reed.co.uk job postings on Apify.** Turn any UK job search into clean, structured JSON — ready for spreadsheets, dashboards, automations, and AI workflows. Results land in your dataset **in real time**, as each job is collected. Built for recruiters, talent teams, job boards, market researchers, and builders who need **reliable UK hiring data at scale** — without slow setups or messy exports. --- ### Why this Actor | | Reed Jobs Real-Time Data | Typical job data tool | |---|--------------------------|------------------------| | **Speed** | Fast per-job collection | Often 5–15 s per job | | **Memory** | **512 MB** default | 2–4 GB+ | | **Setup** | Run in seconds with prefilled input | Often complex configuration | | **Cost** | Low compute, efficient runs | High | | **Output** | Structured JSON, LLM-ready | Often messy or incomplete | | **Scale** | Up to **1,000 jobs** per keyword | Often capped lower | | **Filters** | Full Reed.co.uk search filters | Often keyword-only | | **Modes** | Search · Company jobs · Job links | Usually one mode only | --- ### Three ways to collect jobs | Mode | What it does | Best for | |------|--------------|----------| | **Job search** | Keyword + location search with Reed filters | Market scans, role tracking, location-based hiring | | **Company jobs** | All open roles from specific employers | Competitor monitoring, account-based recruiting | | **Job links** | Structured data from individual Reed job URLs | Enriching a list you already have | Enable one or combine all three in a single run. --- ### What you get — every job, fully structured Each record is one job posting with `featureType`, `jobId`, and `scrapedAt` so you can sort, filter, and join with your own data. | Field | What it tells you | |-------|-------------------| | `title`, `company`, `location`, `remoteWorkingOption` | Role, employer, place, and work style | | `jobUrl`, `applyUrl`, `companyUrl`, `companyLogo` | Direct links and employer branding | | `descriptionText`, `descriptionHtml` | Full job description (when descriptions are enabled) | | `employmentType`, `contractType`, `isFullTime`, `isPartTime` | How the role is classified | | `salary`, `salaryMin`, `salaryMax`, `salaryPeriod` | Compensation signals | | `sector`, `parentSector`, `taxonomy` | Industry and role category | | `isGraduate`, `isEasyApply`, `isAgency`, `isDirectEmployer` | Listing and employer signals | | `postedAt`, `updatedAt`, `expiresAt` | Freshness and availability | | `snippet` | Short preview text from search results | | `searchQuery`, `searchLocation`, `searchCompany`, `position` | Which search produced this row and its rank | | `totalResultsCount` | Total matches for the search query | Set `includeRaw: true` if you need extended record data for custom processing. **`featureType` values:** `job` (search) · `company_job` (company jobs) · `scrape_by_url` (job links) --- ### Search like Reed.co.uk — get data like a database Use the **same filters job seekers use on Reed**: - **Keywords** — one search per keyword (e.g. `software engineer`, `nurse`, `project manager`) - **Title** — narrow to a specific role name - **Company** — filter by employer name - **Location** — London, Manchester, Birmingham, and more (or UK-wide) - **Contract type** — permanent, contract, temporary - **Employment hours** — full-time, part-time - **Work style** — remote, hybrid, on-site - **Date posted** — any time, past month, week, or 24 hours - **Sort** — relevance or most recent - **Salary range** — minimum and maximum in GBP - **Radius** — miles around your location - **Volume** — up to **1,000 jobs per keyword** - **Full descriptions** — toggle complete job text on or off --- ### Use cases — real outcomes - **Recruiting pipelines** — build candidate-ready job lists by role, location, and seniority - **Job boards and aggregators** — feed your product with fresh Reed listings daily - **Market and salary research** — track who is hiring, where, and for what skills - **Competitive intelligence** — monitor competitor hiring by company and function - **Sales and BD** — spot companies in hiring mode for timely outreach - **Staffing agencies** — track UK demand by region, role, and employer - **AI assistants and agents** — summarize listings, score fit, draft outreach, or answer hiring questions - **Data warehouses and CRMs** — push JSON into Snowflake, BigQuery, HubSpot, Airtable, or your stack via API --- ### LLM and MCP integration Output is **structured JSON** — ideal for ChatGPT, Claude, Gemini, LangChain, LlamaIndex, CrewAI, and custom agents. No cleanup step. No manual formatting. Just records your model can read. #### Recommended workflow 1. Run the Actor with your keywords, companies, or job links. 2. Pull dataset items via [Apify API](https://docs.apify.com/api/v2), webhook, or export JSON/CSV. 3. Pass records to your LLM, vector store, or automation — one job per row. #### Example: one job record for an LLM prompt ```json { "featureType": "job", "jobId": "57102667", "title": "R&D Software Engineer", "company": "FDM Group", "location": "London", "remoteWorkingOption": "hybrid", "employmentType": "contract", "salary": "£ 70,000 - £ 80,000 per annum", "descriptionText": "FDM is a global business and technology consultancy seeking a Software Engineer...", "postedAt": "2026-07-08T13:24:24.403", "jobUrl": "https://www.reed.co.uk/jobs/r-d-software-engineer/57102667", "searchQuery": "software engineer", "searchLocation": "London", "position": 1, "scrapedAt": "2026-07-11T12:00:00.000Z" } ```` #### Apify MCP (Model Context Protocol) Use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) so AI assistants can: - **Run** this Actor with natural-language instructions - **Read** dataset results directly in the chat - **Chain** with other Actors (e.g. collect → score → CRM) Typical MCP tool flow: ``` User: "Find 25 remote software engineer jobs in London and summarize each for outreach" → MCP runs Actor with jobKeywords=["software engineer"], jobLocation="London", jobRemote=["remote"] → MCP reads dataset items → LLM summarizes and drafts messages ``` #### API quick start ```bash curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "enableJobSearch": true, "jobKeywords": ["software engineer"], "jobLocation": "London", "jobsPerQuery": 25, "fetchJobDetails": true }' ``` Dataset items: `GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json` *** ### Input reference Enable only what you need. All features are independent. | Input | Type | Default | Description | |-------|------|---------|-------------| | **Job search** | | | | | `enableJobSearch` | boolean | `true` | Keyword + location search | | `jobKeywords` | string\[] | `["software engineer"]` | One search per keyword | | `jobLocation` | string | `London` | City or region (empty = UK-wide) | | `jobTitle` | string | — | Optional title filter | | `jobCompany` | string | — | Optional employer filter | | `jobTypes` | enum\[] | — | permanent, contract, temporary | | `jobEmploymentHours` | enum\[] | — | full\_time, part\_time | | `jobRemote` | enum\[] | — | remote, hybrid, onsite | | `jobDatePosted` | enum | `any` | any, month, week, day | | `jobSort` | enum | `relevance` | relevance or date | | `graduateOnly` | boolean | `false` | Graduate listings only | | `directEmployerOnly` | boolean | `false` | Direct employer preference | | `hideTrainingJobs` | boolean | `false` | Exclude training listings | | `salaryFrom` / `salaryTo` | integer | `0` | Annual salary range (GBP) | | `proximityMiles` | integer | `10` | Search radius in miles | | `jobsPerQuery` | integer | `25` | Max jobs per keyword | | `fetchJobDetails` | boolean | `true` | Full descriptions and employer details | | **Company jobs** | | | | | `enableCompanyJobs` | boolean | `false` | Employer profile scraping | | `companyUrls` | string\[] | — | Reed company profile URLs | | `jobsPerCompany` | integer | `25` | Max jobs per company | | **Job links** | | | | | `enableScrapeByUrl` | boolean | `false` | Scrape individual job URLs | | `jobUrls` | string\[] | — | Reed job page URLs | | **Output & limits** | | | | | `maxItems` | integer | `10000` | Global cap across all features | | `webhookUrl` | string | — | Optional real-time POST URL — dataset is always written; webhook is additional | | `webhookFormat` | enum | `json` | `json` (full record) or `slack` (Slack message) | | `includeRaw` | boolean | `false` | Attach extended record data | | `proxyConfiguration` | object | residential GB | Apify proxy settings | Full schema: see `.actor/input_schema.json` or the **Input** tab on Apify Console. *** ### Output reference Each dataset row is one job record. Filter by `featureType`: | `featureType` | Description | |---------------|-------------| | `job` | Job from keyword search | | `company_job` | Job from company profile | | `scrape_by_url` | Job from a direct URL | **Traceability fields on search results:** - `searchQuery` — keyword that produced this row - `searchLocation` — location used in the search - `position` — rank in results for that search Export formats: **JSON**, **CSV**, **Excel**, **RSS**, or via **API**. *** ### Webhook delivery (optional) Every record is **always saved to the Apify dataset** first. If you set `webhookUrl` in the **Output & limits** section, each new job is **also POSTed in real time** to your endpoint — useful for CRMs, Slack, Zapier, Make, or custom pipelines. | Setting | Description | |---------|-------------| | `webhookUrl` | Your endpoint (https). Leave empty to use dataset only. | | `webhookFormat` | `json` — full job object. `slack` — compact Slack incoming-webhook message. | Webhook delivery is **best-effort**: a failed webhook never stops the run or prevents dataset writes. **Example — search with Slack alerts** ```json { "enableJobSearch": true, "jobKeywords": ["data analyst"], "jobLocation": "Manchester", "jobsPerQuery": 50, "webhookUrl": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL", "webhookFormat": "slack" } ``` **Example — search with JSON webhook to your CRM** ```json { "enableJobSearch": true, "jobKeywords": ["project manager"], "jobLocation": "Birmingham", "fetchJobDetails": true, "webhookUrl": "https://your-crm.example.com/api/jobs", "webhookFormat": "json" } ``` *** ### Quick start — run immediately The default input is **ready to test**. Open the Actor on Apify and click **Start** with no changes: ```json { "enableJobSearch": true, "jobKeywords": ["software engineer"], "jobLocation": "London", "jobsPerQuery": 25, "fetchJobDetails": true } ``` **Remote roles in London** ```json { "enableJobSearch": true, "jobKeywords": ["software engineer"], "jobLocation": "London", "jobRemote": ["remote"], "jobsPerQuery": 50, "fetchJobDetails": true } ``` **Company hiring monitor** ```json { "enableJobSearch": false, "enableCompanyJobs": true, "companyUrls": ["https://www.reed.co.uk/jobs/awin-69909/p69909"], "jobsPerCompany": 50 } ``` **Enrich a URL list** ```json { "enableJobSearch": false, "enableScrapeByUrl": true, "jobUrls": [ "https://www.reed.co.uk/jobs/r-d-software-engineer/57102667" ] } ``` *** ### Proxy & performance - **Apify residential proxy (GB)** is **enabled by default** — optimised for Reed.co.uk. - Default memory: **512 MB** — enough headroom for most runs. - Results are **streamed to the dataset** as they are collected; long runs do not pile up data in memory. *** ### Limitations & compliance - Not affiliated with Reed.co.uk. Use responsibly and comply with applicable laws and Reed's Terms of Service. - Respect rate limits and data protection regulations when collecting and storing job data. - Some filters depend on what Reed.co.uk exposes for a given search — unavailable filters are skipped gracefully. *** ### Contact & custom work Need something beyond this Actor? I build **custom scrapers**, **data pipelines**, and **full-stack web applications** for startups and enterprises. - **Email:** - **GitHub:** [github.com/DrunkCodes](https://github.com/DrunkCodes) Reach out for: - Custom Apify Actors (any website or data source) - UK job market, recruitment, and hiring intelligence at scale - LLM & MCP integrations with your data stack - Web apps, dashboards, and automation tools *** *Reed Jobs Real-Time Data · by [DrunkCodes](https://github.com/DrunkCodes)* # Actor input Schema ## `enableJobSearch` (type: `boolean`): Search Reed.co.uk by keyword and location. Enabled by default — run immediately with the prefilled example below. ## `jobKeywords` (type: `array`): One search per keyword (e.g. software engineer, data analyst, project manager). ## `jobLocation` (type: `string`): City or region on Reed.co.uk (e.g. London, Manchester, Birmingham). Leave empty for UK-wide results. ## `jobTitle` (type: `string`): Optional. Narrow results to jobs whose title contains this text. ## `jobCompany` (type: `string`): Optional. Narrow results to a specific employer name. ## `jobTypes` (type: `array`): Filter by permanent, contract, or temporary roles. ## `jobEmploymentHours` (type: `array`): Filter by full-time or part-time roles. ## `jobRemote` (type: `array`): Filter by remote, hybrid, or on-site work arrangements. ## `jobDatePosted` (type: `string`): Show only jobs posted within this window. ## `jobSort` (type: `string`): Order results by relevance or most recently posted. ## `graduateOnly` (type: `boolean`): Return only graduate-level listings. ## `directEmployerOnly` (type: `boolean`): Prefer listings posted directly by employers. ## `hideTrainingJobs` (type: `boolean`): Exclude training and course-style listings from results. ## `salaryFrom` (type: `integer`): Minimum annual salary in British pounds. Set to 0 for no minimum. ## `salaryTo` (type: `integer`): Maximum annual salary in British pounds. Set to 0 for no maximum. ## `proximityMiles` (type: `integer`): Distance around your location to include in results. ## `jobsPerQuery` (type: `integer`): Maximum jobs to collect for each keyword search. ## `fetchJobDetails` (type: `boolean`): Collect the complete job description, sector, and employer details for each listing. ## `enableCompanyJobs` (type: `boolean`): Collect all open roles from Reed employer profile pages. ## `companyUrls` (type: `array`): Reed employer profile links (e.g. https://www.reed.co.uk/jobs/awin-69909/p69909). ## `jobsPerCompany` (type: `integer`): Maximum jobs to collect from each company profile. ## `enableScrapeByUrl` (type: `boolean`): Collect structured data from individual Reed job URLs you already have. ## `jobUrls` (type: `array`): Full Reed job page URLs (e.g. https://www.reed.co.uk/jobs/software-engineer/57102667). ## `maxItems` (type: `integer`): Global cap across all enabled features in one run. ## `webhookUrl` (type: `string`): Optional. Every record is always saved to the run's dataset — this webhook is an ADDITIONAL real-time push. When set, each new job is also POSTed to this URL (CRM, Slack, Zapier, Make, Google Sheets). ## `webhookFormat` (type: `string`): json = full job record object; slack = Slack-friendly message payload. ## `includeRaw` (type: `boolean`): Attach extended source data on each record. Larger output — for advanced integrations only. ## `proxyConfiguration` (type: `object`): Apify proxy settings. UK residential proxy is enabled by default for reliable Reed.co.uk access. ## Actor input object example ```json { "enableJobSearch": true, "jobKeywords": [ "software engineer" ], "jobLocation": "London", "jobTitle": "", "jobCompany": "", "jobTypes": [], "jobEmploymentHours": [], "jobRemote": [], "jobDatePosted": "any", "jobSort": "relevance", "graduateOnly": false, "directEmployerOnly": false, "hideTrainingJobs": false, "salaryFrom": 0, "salaryTo": 0, "proximityMiles": 10, "jobsPerQuery": 25, "fetchJobDetails": true, "enableCompanyJobs": false, "companyUrls": [], "jobsPerCompany": 25, "enableScrapeByUrl": false, "jobUrls": [], "maxItems": 10000, "webhookUrl": "", "webhookFormat": "json", "includeRaw": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } ``` # Actor output Schema ## `allResults` (type: `string`): Complete dataset with every field from all enabled features in this run. ## `overview` (type: `string`): Compact table — title, company, location, salary, work style, and job link. # 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 = { "enableJobSearch": true, "jobKeywords": [ "software engineer" ], "jobLocation": "London", "jobTitle": "", "jobCompany": "", "jobTypes": [], "jobEmploymentHours": [], "jobRemote": [], "jobDatePosted": "any", "jobSort": "relevance", "graduateOnly": false, "directEmployerOnly": false, "hideTrainingJobs": false, "salaryFrom": 0, "salaryTo": 0, "proximityMiles": 10, "jobsPerQuery": 25, "fetchJobDetails": true, "enableCompanyJobs": false, "companyUrls": [], "jobsPerCompany": 25, "enableScrapeByUrl": false, "jobUrls": [], "maxItems": 10000, "webhookUrl": "", "webhookFormat": "json", "includeRaw": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }; // Run the Actor and wait for it to finish const run = await client.actor("b2b_leads/reed-jobs-real-time-data").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 = { "enableJobSearch": True, "jobKeywords": ["software engineer"], "jobLocation": "London", "jobTitle": "", "jobCompany": "", "jobTypes": [], "jobEmploymentHours": [], "jobRemote": [], "jobDatePosted": "any", "jobSort": "relevance", "graduateOnly": False, "directEmployerOnly": False, "hideTrainingJobs": False, "salaryFrom": 0, "salaryTo": 0, "proximityMiles": 10, "jobsPerQuery": 25, "fetchJobDetails": True, "enableCompanyJobs": False, "companyUrls": [], "jobsPerCompany": 25, "enableScrapeByUrl": False, "jobUrls": [], "maxItems": 10000, "webhookUrl": "", "webhookFormat": "json", "includeRaw": False, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "GB", }, } # Run the Actor and wait for it to finish run = client.actor("b2b_leads/reed-jobs-real-time-data").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 '{ "enableJobSearch": true, "jobKeywords": [ "software engineer" ], "jobLocation": "London", "jobTitle": "", "jobCompany": "", "jobTypes": [], "jobEmploymentHours": [], "jobRemote": [], "jobDatePosted": "any", "jobSort": "relevance", "graduateOnly": false, "directEmployerOnly": false, "hideTrainingJobs": false, "salaryFrom": 0, "salaryTo": 0, "proximityMiles": 10, "jobsPerQuery": 25, "fetchJobDetails": true, "enableCompanyJobs": false, "companyUrls": [], "jobsPerCompany": 25, "enableScrapeByUrl": false, "jobUrls": [], "maxItems": 10000, "webhookUrl": "", "webhookFormat": "json", "includeRaw": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }' | apify call b2b_leads/reed-jobs-real-time-data --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=b2b_leads/reed-jobs-real-time-data", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Reed Jobs Scraper | UK Job Listings & Hiring Data", "description": "Reed jobs scraper, UK jobs, hiring data, job listings, recruiters, staffing, remote jobs, London, structured JSON, job board, market research, CRM, webhook, AI/LLM, real-time, Apify actor.", "version": "0.0", "x-build-id": "1F8MhjmTHBc4n3WFz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~reed-jobs-real-time-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-reed-jobs-real-time-data", "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/b2b_leads~reed-jobs-real-time-data/runs": { "post": { "operationId": "runs-sync-b2b_leads-reed-jobs-real-time-data", "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/b2b_leads~reed-jobs-real-time-data/run-sync": { "post": { "operationId": "run-sync-b2b_leads-reed-jobs-real-time-data", "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": { "enableJobSearch": { "title": "Job search", "type": "boolean", "description": "Search Reed.co.uk by keyword and location. Enabled by default — run immediately with the prefilled example below.", "default": true }, "jobKeywords": { "title": "Keywords", "type": "array", "description": "One search per keyword (e.g. software engineer, data analyst, project manager).", "default": [ "software engineer" ], "items": { "type": "string" } }, "jobLocation": { "title": "Location", "type": "string", "description": "City or region on Reed.co.uk (e.g. London, Manchester, Birmingham). Leave empty for UK-wide results.", "default": "London" }, "jobTitle": { "title": "Title filter", "type": "string", "description": "Optional. Narrow results to jobs whose title contains this text.", "default": "" }, "jobCompany": { "title": "Company filter", "type": "string", "description": "Optional. Narrow results to a specific employer name.", "default": "" }, "jobTypes": { "title": "Contract type", "type": "array", "description": "Filter by permanent, contract, or temporary roles.", "items": { "type": "string", "enum": [ "permanent", "contract", "temporary" ], "enumTitles": [ "Permanent", "Contract", "Temporary" ] }, "default": [] }, "jobEmploymentHours": { "title": "Employment hours", "type": "array", "description": "Filter by full-time or part-time roles.", "items": { "type": "string", "enum": [ "full_time", "part_time" ], "enumTitles": [ "Full-time", "Part-time" ] }, "default": [] }, "jobRemote": { "title": "Work style", "type": "array", "description": "Filter by remote, hybrid, or on-site work arrangements.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] }, "default": [] }, "jobDatePosted": { "title": "Date posted", "enum": [ "any", "month", "week", "day" ], "type": "string", "description": "Show only jobs posted within this window.", "default": "any" }, "jobSort": { "title": "Sort order", "enum": [ "relevance", "date" ], "type": "string", "description": "Order results by relevance or most recently posted.", "default": "relevance" }, "graduateOnly": { "title": "Graduate jobs only", "type": "boolean", "description": "Return only graduate-level listings.", "default": false }, "directEmployerOnly": { "title": "Direct employer only", "type": "boolean", "description": "Prefer listings posted directly by employers.", "default": false }, "hideTrainingJobs": { "title": "Hide training listings", "type": "boolean", "description": "Exclude training and course-style listings from results.", "default": false }, "salaryFrom": { "title": "Minimum salary (GBP)", "minimum": 0, "type": "integer", "description": "Minimum annual salary in British pounds. Set to 0 for no minimum.", "default": 0 }, "salaryTo": { "title": "Maximum salary (GBP)", "minimum": 0, "type": "integer", "description": "Maximum annual salary in British pounds. Set to 0 for no maximum.", "default": 0 }, "proximityMiles": { "title": "Search radius (miles)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Distance around your location to include in results.", "default": 10 }, "jobsPerQuery": { "title": "Jobs per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum jobs to collect for each keyword search.", "default": 25 }, "fetchJobDetails": { "title": "Include full descriptions", "type": "boolean", "description": "Collect the complete job description, sector, and employer details for each listing.", "default": true }, "enableCompanyJobs": { "title": "Company jobs", "type": "boolean", "description": "Collect all open roles from Reed employer profile pages.", "default": false }, "companyUrls": { "title": "Company profile URLs", "type": "array", "description": "Reed employer profile links (e.g. https://www.reed.co.uk/jobs/awin-69909/p69909).", "default": [], "items": { "type": "string" } }, "jobsPerCompany": { "title": "Jobs per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum jobs to collect from each company profile.", "default": 25 }, "enableScrapeByUrl": { "title": "Job links", "type": "boolean", "description": "Collect structured data from individual Reed job URLs you already have.", "default": false }, "jobUrls": { "title": "Job URLs", "type": "array", "description": "Full Reed job page URLs (e.g. https://www.reed.co.uk/jobs/software-engineer/57102667).", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max total items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Global cap across all enabled features in one run.", "default": 10000 }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Every record is always saved to the run's dataset — this webhook is an ADDITIONAL real-time push. When set, each new job is also POSTed to this URL (CRM, Slack, Zapier, Make, Google Sheets).", "default": "" }, "webhookFormat": { "title": "Webhook format", "enum": [ "json", "slack" ], "type": "string", "description": "json = full job record object; slack = Slack-friendly message payload.", "default": "json" }, "includeRaw": { "title": "Include extended record data", "type": "boolean", "description": "Attach extended source data on each record. Larger output — for advanced integrations only.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. UK residential proxy is enabled by default for reliable Reed.co.uk access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } } }, "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 } } } } } } } } } } ```