{ "openapi": "3.0.1", "info": { "title": "Reed Jobs Scraper: UK Jobs and Salaries from reed.co.uk", "description": "Scrape reed.co.uk UK jobs by keyword, location and distance: title, company, agency or employer, salary as numbers with its period, contract type, full or part time, on-site, hybrid or remote, dates, category, link and optional full description. No login.", "version": "0.1", "x-build-id": "snfH7GjicaDgZ7zxd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~reed-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-reed-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/themineworks~reed-jobs-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-reed-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/themineworks~reed-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-reed-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": { "keywords": { "title": "Keywords (job titles or skills)", "type": "array", "description": "One search per line, as you would type it on reed.co.uk, for example software engineer, nurse, accountant, HGV driver. Each keyword is searched in each location. An empty list returns every job that matches the other filters.", "default": [ "software engineer" ], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Towns, cities, counties or postcodes, one per line, for example London, Manchester, Kent, LS1. Each location is its own search, within the distance below. Leave empty for the whole of the UK.", "items": { "type": "string" } }, "distanceMiles": { "title": "Distance from each location (miles)", "minimum": 0, "maximum": 50, "type": "integer", "description": "The site's own distances: 0 (the place only), 1, 3, 5, 10, 15, 20, 30 or 50 miles. Another number goes to the nearest of these. Ignored when no location is given.", "default": 10 }, "salaryMin": { "title": "Salary from (GBP a year)", "minimum": 0, "type": "integer", "description": "Minimum salary, as on the site's salary filter, for example 30000. The site compares hourly and daily rates as yearly pay." }, "salaryMax": { "title": "Salary up to (GBP a year)", "minimum": 0, "type": "integer", "description": "Maximum salary, for example 60000." }, "contractTypes": { "title": "Contract type", "type": "array", "description": "Keep only jobs of these contract types (any of them). Leave empty for any.", "items": { "type": "string", "enum": [ "permanent", "contract", "temporary" ], "enumTitles": [ "Permanent", "Contract", "Temporary" ] } }, "hours": { "title": "Hours", "type": "array", "description": "Keep only full time or part time jobs. Leave empty for any.", "items": { "type": "string", "enum": [ "full_time", "part_time" ], "enumTitles": [ "Full time", "Part time" ] } }, "workingOption": { "title": "On-site, hybrid or remote", "enum": [ "any", "on_site", "hybrid", "remote" ], "type": "string", "description": "Where the work happens, as the site's own filter.", "default": "any" }, "datePosted": { "title": "Date posted", "enum": [ "anytime", "today", "last_3_days", "last_week", "last_2_weeks" ], "type": "string", "description": "Keep only jobs posted in this period.", "default": "anytime" }, "postedBy": { "title": "Posted by", "enum": [ "anyone", "agency", "employer" ], "type": "string", "description": "Jobs from recruitment agencies or from employers directly.", "default": "anyone" }, "graduateOnly": { "title": "Graduate jobs only", "type": "boolean", "description": "Keep only jobs the site marks as graduate jobs.", "default": false }, "easyApplyOnly": { "title": "Easy apply only", "type": "boolean", "description": "Keep only jobs with the site's easy apply.", "default": false }, "visaSponsorshipOnly": { "title": "Visa sponsorship only", "type": "boolean", "description": "Keep only jobs that offer visa sponsorship.", "default": false }, "salaryShownOnly": { "title": "Only jobs that show a salary", "type": "boolean", "description": "Leave out jobs without a salary on display.", "default": false }, "hideTrainingCourses": { "title": "Hide training courses", "type": "boolean", "description": "Leave out the paid training course listings the site mixes into job results. On by default.", "default": true }, "maxJobs": { "title": "Max jobs per search", "minimum": 25, "maximum": 5000, "type": "integer", "description": "Upper limit per search (one keyword in one location), 25 to 5,000. The site shows 25 jobs a page. Also the most you pay for per search.", "default": 100 }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Adds the full job description (text and HTML), the salary exactly as the site shows it, sector, town, postcode, region and country. One extra page per job.", "default": false }, "onlyNewJobs": { "title": "Only jobs not delivered before", "type": "boolean", "description": "For schedules: skip jobs an earlier run of this actor in your account already delivered, so each run returns and charges only new jobs. Works best with Date posted. The list of delivered jobs is kept in a named key value store in your account.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }