Reed.co.uk API
The Reed.co.uk API returns UK job listings as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns jobs with id, title, URL, company, location, county, job type and full/part-time flags, and you can pull a detail, a company's jobs and a sector. It is built for recruiting tools, UK labor-market analysts and job boards that need Reed data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/reed/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"keywords": "python developer",
"location": "London"
}
}{
"ok": true,
"meta": {
"api": "reed",
"endpoint": "search",
"mode": "live",
"latency_ms": 508.6,
"record_count": 25,
"bytes": 391359,
"cache_hit": false,
"completeness_pct": 100,
"stop_reason": "limit_reached",
"method": "ssr_next_data",
"pagination": {
"page": 1,
"total_pages": 22,
"has_more": true,
"next_page": 2
}
},
"data": {
"jobs": [
{
"job_id": 57067408,
"title": "Python Developer",
"url": "https://www.reed.co.uk/jobs/python-developer/57067408",
"company": "McGregor Boyall",
"company_slug": "mcgregor-boyall-associates-limited",
"location": "London",
"county": "London",
"job_type": "Permanent",
"is_full_time": true,
"is_part_time": false,
"remote_option": "On-Site",
"posted_date": "[redacted-phone]T10:22:10.303",
"expiry_date": "[redacted-phone]T23:55:00",
"is_easy_apply": true,
"is_promoted": false,
"sector_top": "Developer",
"sector": "Python Developer",
"external_url": null,
"description_text": null,
"salary_from": 70000,
"salary_to": 100000,
"salary_period": "per annum",
"salary_description": "£70,000 - £100,000 per annum",
"currency": "GBP"
},
{
"job_id": 57000202,
"title": "Backend Python Developer",
"url": "https://www.reed.co.uk/jobs/backend-python-developer/57000202",
"company": "Xact Placements Limited",
"company_slug": "xact-placements-limited",
"location": "London",
"county": "London",
"job_type": "Permanent",
"is_full_time": true,
"is_part_time": false,
"remote_option": "Remote",
"posted_date": "[redacted-phone]T11:06:07.68",
"expiry_date": "[redacted-phone]T23:59:59",
"is_easy_apply": true,
"is_promoted": false,
"sector_top": "Developer",
"sector": "Python Developer",
"external_url": null,
"description_text": null,
"salary_from": 60000,
"salary_to": 80000,
"salary_period": "per annum",
"salary_description": "£60,000 - £80,000 per annum",
"currency": "GBP"
},
{
"job_id": 57030831,
"title": "Senior Django / Python Developer",
"url": "https://www.reed.co.uk/jobs/senior-django-python-developer/57030831",
"company": "Sanderson ",
"company_slug": "sanderson-35038",
"location": "London",
"county": "London",
"job_type": "Temporary",
"is_full_time": true,
"is_part_time": false,
"remote_option": "Hybrid",
"posted_date": "[redacted-phone]T15:23:30.447",
"expiry_date": "[redacted-phone]T23:55:00",
"is_easy_apply": true,
"is_promoted": false,
"sector_top": "Developer",
"sector": "Python Developer",
"external_url": null,
"description_text": null,
"salary_from": 600,
"salary_to": 700,
"salary_period": "per day",
"salary_description": "£600 - £700 per day",
"currency": "GBP"
}
],
"total": 531
}
}What the Reed.co.uk API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Reed.co.uk job postings by keyword with optional location, distance, salary range, job-type, date-posted, remote and sort filters. Returns up to 25 jobs per page with title, company, salary, location, dates and a plain-text description. | Recruiting teams call search to search Reed.co.uk job postings by keyword with optional location, distance, salary range, job…. | keywords, location, distance, job_type, full_time, ... |
| detail | Full posting for one Reed job by job_id (or a Reed job URL): title, company, salary (range + display), location breakdown (town/county/region/country/postcode/remote), full HTML + plain-text description, contract type, sector, eligibility, dates and breadcrumbs — plus related jobs. | Labor-market analysts call detail to get full posting for one Reed job by job_id (or a Reed job URL). | job_id, url, include_similar |
| company-jobs | All public job postings at a specific company on Reed. Pass the company's Reed profile slug, full company URL, or its name; optionally narrow with the same keyword/location/salary/job-type/date filters as search. | Job boards call company-jobs to get all public job postings at a specific company on Reed. | company, keywords, location, distance, job_type, ... |
| sector | Browse Reed jobs by sector/category (e.g. 'it', 'accountancy', 'healthcare', 'engineering', 'sales', 'marketing'). Optionally scope by location and the same salary/job-type/date/remote filters as search. | Sales intelligence teams call sector to get browse Reed jobs by sector/category (e.g. | sector, location, distance, job_type, salary_from, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/reed/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"keywords":"python developer","location":"London"}'import requests
r = requests.post(
"https://api.reefapi.com/reed/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"keywords": "python developer",
"location": "London"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/reed/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"keywords": "python developer",
"location": "London"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.reed.search with {"keywords":"python developer","location":"London"}.Who uses this API and why
- UK job boards call search to aggregate fresh Reed listings by role and location.
- Labor-market analysts use sector and search to measure hiring demand across the UK.
- Recruiting tools use company-jobs to track a specific employer's open roles.
Questions developers ask before integrating
What is the Reed.co.uk API?
Reed.co.uk API is a ReefAPI endpoint group for reed.co.uk It returns live JSON through POST requests under /reed/v1.
Is the Reed.co.uk API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Reed.co.uk calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Reed.co.uk login or account?
No login to Reed.co.uk is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Reed.co.uk data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Reed.co.uk API use?
Reed.co.uk actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Reed.co.uk from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call reed actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Reed.co.uk API a Reed.co.uk scraper?
It is the managed alternative to a DIY Reed.co.uk scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same reed.co.uk back as clean JSON.
Why does my Reed.co.uk scraper keep getting blocked?
Most Reed.co.uk scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.