docs / reed

Reed.co.uk API

base /reed/v14 endpoints

post/reed/v1/search1 credit

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.

Parameter		Allowed / range	Description
keywords	required	—	What job to search for — a job title, skill or keyword ('python developer', 'registered nurse', 'accountant').
location	optional	—	UK town, city or region to search in (free text, e.g. 'London', 'Manchester', 'Birmingham'). Pair with `distance`.
distance = 10	optional	0–50	Search radius in miles around the location (Reed bands: 0/1/3/5/10/15/20/30/50).
job_type	optional	permanent · temporary · contract	Restrict to one employment type.
full_time	optional	—	Only full-time jobs.
part_time	optional	—	Only part-time jobs.
graduate	optional	—	Only graduate-level jobs.
agency	optional	—	Only jobs posted by recruitment agencies.
employer	optional	—	Only jobs posted directly by the employer (not an agency).
salary_from	optional	0–	Minimum annual salary in GBP (Reed banded, e.g. 40000).
salary_to	optional	0–	Maximum annual salary in GBP (Reed banded, e.g. 80000).
date_posted	optional	anytime · today · lastthreedays · lastweek · lasttwoweeks	Only jobs posted within this window.
remote	optional	remote · hybrid · onsite	Filter by working arrangement.
visa_sponsorship	optional	—	Only jobs offering visa sponsorship.
easy_apply	optional	—	Only Reed 'Easy Apply' jobs.
sort = default	optional	default · date · salarydesc · salaryasc · distance	Result ordering.
page = 1	optional	1–200	Result page (25 jobs per page). Page until meta.total_pages.

Try in playground →

post/reed/v1/detail1 credit

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.

Parameter		Allowed / range	Description
job_id	optional	—	Reed job ID — the number in the job URL (reed.co.uk/jobs/<slug>/<job_id>) or `job_id` from search.
url	optional	—	Alternatively a full Reed job URL.
include_similar = false	optional	—	Also return Reed's related/similar jobs for this posting.

Try in playground →

post/reed/v1/company-jobs1 credit

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.

Parameter		Allowed / range	Description
company	required	—	The employer — its Reed company profile slug (the part of reed.co.uk/jobs/<slug>-jobs), a full Reed company URL, or the company name (resolved to a slug automatically). The `company_slug` field on any search result is a valid input.
keywords	optional	—	Optional: also filter the company's jobs by keyword.
location	optional	—	UK town, city or region to search in (free text, e.g. 'London', 'Manchester', 'Birmingham'). Pair with `distance`.
distance = 10	optional	0–50	Search radius in miles around the location (Reed bands: 0/1/3/5/10/15/20/30/50).
job_type	optional	permanent · temporary · contract	Restrict to one employment type.
salary_from	optional	0–	Minimum annual salary in GBP (Reed banded, e.g. 40000).
salary_to	optional	0–	Maximum annual salary in GBP (Reed banded, e.g. 80000).
date_posted	optional	anytime · today · lastthreedays · lastweek · lasttwoweeks	Only jobs posted within this window.
remote	optional	remote · hybrid · onsite	Filter by working arrangement.
sort = default	optional	default · date · salarydesc · salaryasc · distance	Result ordering.
page = 1	optional	1–200	Result page (25 jobs per page). Page until meta.total_pages.

Try in playground →

post/reed/v1/sector1 credit

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.

Parameter		Allowed / range	Description
sector	required	—	Reed sector slug — e.g. 'it', 'accountancy', 'healthcare', 'engineering', 'sales', 'marketing', 'education', 'construction', 'hospitality', 'legal'.
location	optional	—	UK town, city or region to search in (free text, e.g. 'London', 'Manchester', 'Birmingham'). Pair with `distance`.
distance = 10	optional	0–50	Search radius in miles around the location (Reed bands: 0/1/3/5/10/15/20/30/50).
job_type	optional	permanent · temporary · contract	Restrict to one employment type.
salary_from	optional	0–	Minimum annual salary in GBP (Reed banded, e.g. 40000).
salary_to	optional	0–	Maximum annual salary in GBP (Reed banded, e.g. 80000).
date_posted	optional	anytime · today · lastthreedays · lastweek · lasttwoweeks	Only jobs posted within this window.
remote	optional	remote · hybrid · onsite	Filter by working arrangement.
sort = default	optional	default · date · salarydesc · salaryasc · distance	Result ordering.
page = 1	optional	1–200	Result page (25 jobs per page). Page until meta.total_pages.

Try in playground →

Example request · search

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"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}