{ "openapi": "3.0.1", "info": { "title": "Reed.co.uk Jobs Scraper", "description": "Scrape public Reed.co.uk job listings and return structured records with titles, employers, locations, salary details, contract types, descriptions, and posting and closing dates. The Actor opens each job page to collect the full description and exact posting date, and requires no login or API key.", "version": "0.1", "x-build-id": "PLwX50r0Tgy469gaN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~reed-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-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/axiomworks~reed-jobs-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-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/axiomworks~reed-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "string", "description": "First job keyword or phrase to search, e.g. software engineer. Add more searches with additionalKeywords; ignored when startUrls is set." }, "location": { "title": "Location", "type": "string", "description": "UK town, city or area to search in, e.g. 'London' or 'Manchester'. Leave empty to search all of the UK. Ignored when startUrls is set." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional Reed.co.uk search result URLs or single job URLs (https://www.reed.co.uk/jobs//). When set, they override keywords and location.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of jobs to return, 1-5000, default 50. The run stops as soon as this many records are saved.", "default": 50 }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Include the full job description as plain text. Default true.", "default": true }, "enableAiEnrichment": { "title": "AI enrichment", "type": "boolean", "description": "Add seniority (entry/mid/senior/lead/executive) and remoteType (onsite/hybrid/remote/unspecified) to each job using a third-party AI processor. Default false.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Requests go direct by default; if Reed blocks them the Actor retries through Apify datacenter proxy. Choose a proxy group here to always use one.", "default": { "useApifyProxy": false } }, "additionalKeywords": { "title": "Additional keywords", "type": "array", "description": "More job searches to combine with keywords, e.g. [\"data engineer\", \"backend developer\"]. Duplicate job IDs are returned once. Ignored when startUrls is set.", "items": { "type": "string" }, "default": [] }, "salaryFrom": { "title": "Salary from", "minimum": 0, "type": "integer", "description": "Minimum salary filter value in GBP for Reed search results, e.g. 50000. Reed decides how each listing matches its salary filter; 0 means any.", "default": 0 }, "salaryTo": { "title": "Salary to", "minimum": 0, "type": "integer", "description": "Maximum salary filter value in GBP for Reed search results, e.g. 100000. Reed decides how each listing matches its salary filter; 0 means any.", "default": 0 }, "jobType": { "title": "Job type", "enum": [ "any", "permanent", "contract", "temporary", "fullTime", "partTime" ], "type": "string", "description": "Job type to request from Reed: permanent, contract, temporary, fullTime or partTime. Default any.", "default": "any" } } }, "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 } } } } } } } } } }