{ "openapi": "3.0.1", "info": { "title": "Reed Jobs Scraper: UK Job Listings & Salaries", "description": "Scrape UK job listings from Reed.co.uk by keyword, location and date. Extract job title, company, salary range, location, working option, posting date and optional full descriptions. Export JSON, CSV or Excel, use the API, or schedule runs.", "version": "0.1", "x-build-id": "OpylchO7lwgS48FSX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/buy-it~reed-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-buy-it-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/buy-it~reed-jobs-scraper/runs": { "post": { "operationId": "runs-sync-buy-it-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/buy-it~reed-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-buy-it-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Job titles or keywords to search for, one per line, for example \"software engineer\" or \"nurse\".", "items": { "type": "string" } }, "startUrls": { "title": "Reed search URLs (optional)", "type": "array", "description": "Paste any Reed search results page, for example after setting filters on reed.co.uk. Used together with the keywords above.", "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 town, city or region, for example \"London\". Leave empty to search all of the UK." }, "radiusMiles": { "title": "Search radius (miles)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Distance around the location. Only used when a location is set.", "default": 10 }, "datePosted": { "title": "Date posted", "enum": [ "anytime", "today", "lastThreeDays", "lastWeek", "lastTwoWeeks" ], "type": "string", "description": "Only return jobs posted within this period.", "default": "anytime" }, "salaryFrom": { "title": "Minimum salary (GBP per year)", "minimum": 0, "type": "integer", "description": "Only jobs paying at least this much per year." }, "salaryTo": { "title": "Maximum salary (GBP per year)", "minimum": 0, "type": "integer", "description": "Only jobs paying up to this much per year." }, "jobTypes": { "title": "Job type", "type": "array", "description": "Leave empty for all types. Choose several to combine them.", "items": { "type": "string", "enum": [ "permanent", "contract", "temporary" ], "enumTitles": [ "Permanent", "Contract", "Temporary" ] } }, "workingHours": { "title": "Working hours", "enum": [ "any", "fullTime", "partTime" ], "type": "string", "description": "Only full-time or only part-time jobs. Leave on Any for both.", "default": "any" }, "workingOption": { "title": "Remote or on-site", "enum": [ "any", "onSite", "hybrid", "remote" ], "type": "string", "description": "Filter by where the work is done: on-site, hybrid or fully remote.", "default": "any" }, "postedBy": { "title": "Posted by", "enum": [ "any", "agency", "employer" ], "type": "string", "description": "Only jobs posted by a recruitment agency, or only by the hiring employer directly.", "default": "any" }, "onlyWithSalary": { "title": "Only jobs that show a salary", "type": "boolean", "description": "Hide jobs without a displayed salary.", "default": false }, "onlyNewJobs": { "title": "Only jobs not returned before", "type": "boolean", "description": "Skips jobs this account already received in earlier runs, so scheduled runs return only new listings. Best combined with a Date posted filter.", "default": false }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many jobs in total across all keywords and URLs.", "default": 100 }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Opens each job page to add the full description, contract type, sector group and whether an agency or employer posted it (slower and uses more compute).", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for requests.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }