Reed API

Beginner's Pick Jobs / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

Reed is a UK-based job board API that lets you search and retrieve job listings programmatically. You can filter jobs by keywords, location, salary, and employer to find relevant postings. It is ideal for building job search apps or aggregating employment opportunities across the UK.

Beginner Tip

Use your API key as the username in HTTP Basic Auth with an empty password—Reed does not use a Bearer token format. Always encode your key correctly by passing YOUR_API_KEY followed by a colon as the Basic auth credential.

Available Data

Use case: Integrate job board aggregator data into web and mobile applications
Reed data via REST API

Example Response

JSON Response
{
  "title": "Software Engineer",
  "company": "Tech Corp",
  "location": "Remote",
  "salary_range": "$120,000 - $180,000",
  "posted_date": "2025-01-10",
  "description": "We are looking for an experienced..."
}

Field Reference

jobId Unique identifier for the job listing on Reed.
jobTitle Title of the job position as posted by the employer.
locationName City or region where the job is located.
minimumSalary Minimum annual salary offered for the role in GBP.
maximumSalary Maximum annual salary offered for the role in GBP.
jobUrl Direct URL to the full job listing on the Reed website.

Implementation Example

Request
const url = "https://www.reed.co.uk/developers";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Incorrect API key format; Reed uses HTTP Basic Auth with the key as the username and an empty password.
Set the Authorization header to Basic base64(YOUR_API_KEY:) with a colon but no password, or use curl -u YOUR_API_KEY: syntax.
400 Bad Request Missing or invalid query parameters such as blank keywords and no location.
Always supply at least one of keywords, locationName, or employerId in your request.
Empty results array Search terms are too specific or the location spelling does not match Reed's index.
Broaden your keyword search or try a major city name like London as the location.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Jobs
Difficulty Intermediate
Verified: 2026-04-04

Related Tags

Similar APIs

View All →