Reed Jobs Scraper
Pricing
from $1.80 / 1,000 jobs
Search and export UK job vacancies from Reed with employer, location, contract type and salary, including an annualised figure so hourly and salaried roles can be compared.
You can access the Reed Jobs Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "rtwg1A1ZvA5msN9dc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spookyweb~uk-jobs-reed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spookyweb-uk-jobs-reed", "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/spookyweb~uk-jobs-reed/runs": { "post": { "operationId": "runs-sync-spookyweb-uk-jobs-reed", "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/spookyweb~uk-jobs-reed/run-sync": { "post": { "operationId": "run-sync-spookyweb-uk-jobs-reed", "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", "type": "string", "description": "Job title or keywords, for example nurse or software developer." }, "location": { "title": "Location", "type": "string", "description": "Town, city or county, for example manchester or london." }, "proximityMiles": { "title": "Distance in miles", "minimum": 0, "maximum": 100, "type": "integer", "description": "Search radius in miles around the location. Reed measures this from the town or postcode given, so a wider radius pulls in neighbouring areas.", "default": 10 }, "salaryFrom": { "title": "Minimum salary", "type": "integer", "description": "Lowest annual salary to accept, in GBP. Reed filters on the advertised range, so jobs that publish no salary are dropped when this is set." }, "salaryTo": { "title": "Maximum salary", "type": "integer", "description": "Highest annual salary to accept, in GBP. Reed filters on the advertised range, so jobs that publish no salary are dropped when this is set." }, "datePosted": { "title": "Posted within", "enum": [ "anytime", "today", "lastthreedays", "lastweek", "lastmonth" ], "type": "string", "description": "Only return jobs posted within this window. Reed's API has no date filter, so this is applied to the results after they are fetched.", "default": "anytime" }, "permanent": { "title": "Permanent only", "type": "boolean", "description": "Include permanent roles. Leaving every contract type switched off returns all of them, so these switches narrow the search rather than widen it.", "default": false }, "contract": { "title": "Contract only", "type": "boolean", "description": "Include fixed term contract roles. Leaving every contract type switched off returns all of them, so these switches narrow the search rather than widen it.", "default": false }, "temporary": { "title": "Temporary only", "type": "boolean", "description": "Include temporary roles. Leaving every contract type switched off returns all of them, so these switches narrow the search rather than widen it.", "default": false }, "fullTime": { "title": "Full time only", "type": "boolean", "description": "Include full time roles. Combine with a contract type to narrow further, for example full time and permanent together.", "default": false }, "partTime": { "title": "Part time only", "type": "boolean", "description": "Include part time roles. Combine with a contract type to narrow further, for example part time and temporary together.", "default": false }, "graduate": { "title": "Graduate roles only", "type": "boolean", "description": "Include roles Reed flags as suitable for graduates. These are a subset of the main listings rather than a separate job board.", "default": false }, "includePromoted": { "title": "Include promoted listings (no longer used)", "type": "boolean", "description": "Kept so existing saved inputs stay valid. Reed's API does not mark promoted listings, so this setting has no effect.", "default": false }, "maxResults": { "title": "Max jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on results. Each job is one billable result. Reed serves up to 1000 results per search through the API, in pages of 100.", "default": 100 }, "reedApiKey": { "title": "Reed API key (optional)", "type": "string", "description": "Leave blank to use the built in key. Supply your own free key from reed.co.uk/developers if you would rather run against your own account." }, "fetchDetails": { "title": "Fetch full job details", "type": "boolean", "description": "On by default. Adds the salary period, Reed's own annualised salary, contract type, full or part time and the complete job description. Costs one extra fast request per job.", "default": true } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Reed Jobs Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: