{ "openapi": "3.0.1", "info": { "title": "Reed Jobs Scraper: UK Job Listings from Reed.co.uk", "description": "Scrape UK jobs from Reed.co.uk by keyword, location, job type, salary and date posted, or from any Reed search URL. Returns salary range, full description, skills, contract type, sector, postcode and recruiter. $2.00 per 1,000 jobs.", "version": "1.0", "x-build-id": "Lb1CgB0jU5Vau2bgA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pulsedata~reed-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pulsedata-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/pulsedata~reed-jobs-scraper/runs": { "post": { "operationId": "runs-sync-pulsedata-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/pulsedata~reed-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-pulsedata-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search keywords or Reed URLs", "minItems": 1, "type": "array", "description": "One search per line. Use job keywords like `data analyst` or `nurse`, or paste a Reed search URL such as `https://www.reed.co.uk/jobs/nurse-jobs-in-manchester?perm=true` (its filters are used as they are).", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Town, county or postcode as you would type it on Reed, for example `London`, `Manchester` or `M1`. Empty searches the whole UK.", "default": "" }, "distanceMiles": { "title": "Distance (miles)", "minimum": 0, "maximum": 50, "type": "integer", "description": "Radius around the location: 0, 1, 3, 5, 10, 15, 20, 30 or 50 miles. Other numbers round up to the next of these. Only used with a location.", "default": 10 }, "jobTypes": { "title": "Job types", "type": "array", "description": "Only these job types: `permanent`, `temporary`, `contract`, `full-time`, `part-time`. Empty means all.", "default": [], "items": { "type": "string" } }, "workingOptions": { "title": "Working arrangement", "type": "array", "description": "Only these arrangements: `on-site`, `hybrid`, `remote`. Empty means all. With more than one value the actor runs one search per value and removes duplicates.", "default": [], "items": { "type": "string" } }, "postedWithin": { "title": "Posted within", "enum": [ "anytime", "today", "lastthreedays", "lastweek", "lasttwoweeks" ], "type": "string", "description": "Only jobs posted in this period.", "default": "anytime" }, "salaryFrom": { "title": "Minimum salary (GBP per year)", "minimum": 0, "type": "integer", "description": "Passed to Reed's minimum salary filter, GBP per year. Reed matches on the advertised range, so a £60,000 to £80,000 ad counts for a £70,000 minimum, and it also returns some ads with no stated salary. Filter on salaryFromPerYear afterwards for a strict cut-off. 0 means no minimum.", "default": 0 }, "salaryTo": { "title": "Maximum salary (GBP per year)", "minimum": 0, "type": "integer", "description": "Passed to Reed's maximum salary filter, GBP per year. Reed matches on the advertised range and may return ads with no stated salary. Filter on salaryToPerYear afterwards for a strict cut-off. 0 means no maximum.", "default": 0 }, "includeDetails": { "title": "Include full details", "type": "boolean", "description": "Add the full description, skills, contract type, sector, region, postcode and recruiter details. One extra request per job, same price.", "default": true }, "maxResults": { "title": "Max jobs per search", "minimum": 0, "type": "integer", "description": "Stop each search after this many jobs. 0 means all.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "UK residential proxy is the default. Reed blocks datacenter IPs after a few pages.", "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 }, "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 } } } } } } } } } }