Totaljobs
UK job ads from Totaljobs: search with every site filter, full ads with salary, employers and career advice.
/totaljobs/v1/search1 creditSearch live Totaljobs (UK) job ads by keyword and location with the site's filters: radius in miles, date posted, minimum salary (annual, daily or hourly), job type, home working, sort; plus the newer engine's hybrid/on-site/remote, contract type, discipline, skill, sector, city and easy-apply filters. Up to 25 jobs per page with the employer's printed salary and its parsed range.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Job title, skill or keyword, as typed into Totaljobs' 'what' box. Either `query` or `location` is required. |
| location | optional | — | Town, city or postcode (Totaljobs' 'where' box). An unknown place returns NOT_FOUND; `autocomplete` with type=location lists the names the site knows. |
| radius = 10 | optional | 0–100 | Distance around `location`, in MILES (site default 10; the site's own menu offers 0, 5, 10, 20, 30). Measured nurse / Leeds: 0 mi = 103, 10 mi = 147, 30 mi = 400, 100 mi = 1,884 exact matches. |
| page = 1 | optional | 1–2000 | Result page, up to 25 jobs per page. `last_page` / `has_more` say when to stop; a page past the last one returns NOT_FOUND. Measured: page 400 of 423 still answers. |
| sort | optional | relevance · date | relevance (site default) or date (newest first). Measured python / London: relevance page 1 spans 12 Oct-17 Nov, date page 1 spans 18-19 Nov. |
| search_engine | optional | classic · new | Which of Totaljobs' two search engines answers. classic = what most visitors get (default); new = StepStone's newer engine with hybrid/on-site/remote, contract type, discipline, skill, sector, city and application-method filters. Left empty, a new-engine-only filter selects `new` automatically. The two engines count differently for the same words (python / London: classic 750 exact matches, new 679). |
| posted_within_days | optional | 1 · 3 · 7 · 14 | Only jobs posted in the last N days. Classic engine: 1, 3, 7, 14; newer engine: 1, 7. Measured python / London exact matches: 750 -> 36 (1 day), 97 (3), 142 (7), 290 (14); newer engine 679 -> 35 (1), 190 (7). |
| min_salary | optional | 1–10000000 | Minimum salary in GBP for `salary_period` (default annual). Classic engine: any amount; the newer engine only its steps 10,000 to 100,000 by 10,000. The site's own buckets are in `facets`. Measured python / London exact matches: 750 -> 305 at 50,000 a year, 299 at 55,000, 73 at 400 a day, 299 at 30 an hour. |
| salary_period | optional | annual · daily · hourly | What `min_salary` is per: annual (default), daily or hourly (daily / hourly are classic-engine only). |
| job_type | optional | permanent · contract · temporary · part_time · work_from_home | Classic-engine job type. Measured python / London 750 -> permanent 609, contract 137, part_time 64, work_from_home 199, temporary 0. |
| remote | optional | only · exclude | Classic-engine home-working filter: only = jobs marked work-from-home, exclude = the rest. Measured python / London 750 -> 252 (only), 497 (exclude). |
| work_policy | optional | on_site · hybrid · remote | New engine. Measured python / London 679 -> on_site 408, hybrid 235, remote 34. |
| contract_type | optional | permanent · temporary · freelance · temp_staffing | New engine. Measured python / London 679 -> permanent 552, temporary 120. |
| work_type | optional | full_time · part_time | New engine full-time / part-time. Measured python / London 679 -> full_time 9, part_time 1 (most ads do not set it). |
| application_method | optional | easy_apply · company_website | New engine: easy_apply = Totaljobs' own application form, company_website = apply on the employer's site. Measured 679 -> 273 / 406. |
| discipline | optional | — | New engine discipline id from `facets.herdwickDisciplines` (e.g. IT, Engineering). Measured python / London 679 -> 463 (IT). |
| skill_id | optional | — | New engine skill id from `facets.skills` (240010 = Python). Measured 679 -> 565. |
| category_id | optional | — | New engine job-title category id from `facets.categories`. Measured 679 -> 17. |
| sector_id | optional | — | New engine sector id from `facets.sectors` (611392 = IT & Tech). Measured 679 -> 61. |
| city_id | optional | — | New engine city id from `facets.cities` (100552 = London). Measured 679 -> 670. |
| region_id | optional | — | New engine region id from `facets.regions`. |
| country_id | optional | — | New engine country id from `facets.countries` (538267 = England). Measured 679 -> 674. |
/totaljobs/v1/filters1 creditMarket counts for a search without the job rows: every filter value with its live count (date posted, job type, company type, salary bands, skills, sectors …), popular locations with counts, related and nearby searches, part-time and temporary totals. Empty query and location = the whole UK board.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Optional keyword. Leave both `query` and `location` empty for the whole UK board. |
| location | optional | — | Optional town, city or postcode. |
| radius = 10 | optional | 0–100 | Distance around `location`, in MILES (site default 10; the site's own menu offers 0, 5, 10, 20, 30). Measured nurse / Leeds: 0 mi = 103, 10 mi = 147, 30 mi = 400, 100 mi = 1,884 exact matches. |
| search_engine | optional | classic · new | Which of Totaljobs' two search engines answers. classic = what most visitors get (default); new = StepStone's newer engine with hybrid/on-site/remote, contract type, discipline, skill, sector, city and application-method filters. Left empty, a new-engine-only filter selects `new` automatically. The two engines count differently for the same words (python / London: classic 750 exact matches, new 679). |
| posted_within_days | optional | 1 · 3 · 7 · 14 | Only jobs posted in the last N days. Classic engine: 1, 3, 7, 14; newer engine: 1, 7. Measured python / London exact matches: 750 -> 36 (1 day), 97 (3), 142 (7), 290 (14); newer engine 679 -> 35 (1), 190 (7). |
| min_salary | optional | 1–10000000 | Minimum salary in GBP for `salary_period` (default annual). Classic engine: any amount; the newer engine only its steps 10,000 to 100,000 by 10,000. The site's own buckets are in `facets`. Measured python / London exact matches: 750 -> 305 at 50,000 a year, 299 at 55,000, 73 at 400 a day, 299 at 30 an hour. |
| salary_period | optional | annual · daily · hourly | What `min_salary` is per: annual (default), daily or hourly (daily / hourly are classic-engine only). |
| job_type | optional | permanent · contract · temporary · part_time · work_from_home | Classic-engine job type. Measured python / London 750 -> permanent 609, contract 137, part_time 64, work_from_home 199, temporary 0. |
| remote | optional | only · exclude | Classic-engine home-working filter: only = jobs marked work-from-home, exclude = the rest. Measured python / London 750 -> 252 (only), 497 (exclude). |
| work_policy | optional | on_site · hybrid · remote | New engine. Measured python / London 679 -> on_site 408, hybrid 235, remote 34. |
| contract_type | optional | permanent · temporary · freelance · temp_staffing | New engine. Measured python / London 679 -> permanent 552, temporary 120. |
| work_type | optional | full_time · part_time | New engine full-time / part-time. Measured python / London 679 -> full_time 9, part_time 1 (most ads do not set it). |
| application_method | optional | easy_apply · company_website | New engine: easy_apply = Totaljobs' own application form, company_website = apply on the employer's site. Measured 679 -> 273 / 406. |
| discipline | optional | — | New engine discipline id from `facets.herdwickDisciplines` (e.g. IT, Engineering). Measured python / London 679 -> 463 (IT). |
| skill_id | optional | — | New engine skill id from `facets.skills` (240010 = Python). Measured 679 -> 565. |
| category_id | optional | — | New engine job-title category id from `facets.categories`. Measured 679 -> 17. |
| sector_id | optional | — | New engine sector id from `facets.sectors` (611392 = IT & Tech). Measured 679 -> 61. |
| city_id | optional | — | New engine city id from `facets.cities` (100552 = London). Measured 679 -> 670. |
| region_id | optional | — | New engine region id from `facets.regions`. |
| country_id | optional | — | New engine country id from `facets.countries` (538267 = England). Measured 679 -> 674. |
/totaljobs/v1/search_by_url1 creditJobs behind any totaljobs.com search or employer link (with the site's own filters in the link), page by page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| url | required | — | A totaljobs.com /jobs/… search link or an employer link (/jobs-at/<name>/jobs?cmpId=… or /jobs/<name>?cmpId=…&cmp=1). |
| page = 1 | optional | 1–2000 | Result page, up to 25 jobs per page. `last_page` / `has_more` say when to stop; a page past the last one returns NOT_FOUND. Measured: page 400 of 423 still answers. |
/totaljobs/v1/company_jobs1 creditAll open jobs of one employer on Totaljobs, 25 per page, with optional keyword, date, job-type, home-working and salary filters.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| company_id | optional | — | The employer's `company_id` from a search row or a job. Either `company_id` or `company` is required. |
| company | optional | — | Employer name; resolved to its id through the search box's own company suggestions (one extra 1-2 KB request). Ambiguous or unknown names return NOT_FOUND with the closest suggestions. |
| query | optional | — | Optional keyword inside the employer's jobs. |
| page = 1 | optional | 1–2000 | Result page, up to 25 jobs per page. `last_page` / `has_more` say when to stop; a page past the last one returns NOT_FOUND. Measured: page 400 of 423 still answers. |
| sort | optional | relevance · date | relevance (site default) or date (newest first). Measured python / London: relevance page 1 spans 12 Oct-17 Nov, date page 1 spans 18-19 Nov. |
| posted_within_days | optional | 1 · 3 · 7 · 14 | Only jobs posted in the last N days. Classic engine: 1, 3, 7, 14; newer engine: 1, 7. Measured python / London exact matches: 750 -> 36 (1 day), 97 (3), 142 (7), 290 (14); newer engine 679 -> 35 (1), 190 (7). |
| job_type | optional | permanent · contract · temporary · part_time · work_from_home | Classic-engine job type. Measured python / London 750 -> permanent 609, contract 137, part_time 64, work_from_home 199, temporary 0. |
| remote | optional | only · exclude | Classic-engine home-working filter: only = jobs marked work-from-home, exclude = the rest. Measured python / London 750 -> 252 (only), 497 (exclude). |
| min_salary | optional | 1–10000000 | Minimum salary in GBP for `salary_period` (default annual). Classic engine: any amount; the newer engine only its steps 10,000 to 100,000 by 10,000. The site's own buckets are in `facets`. Measured python / London exact matches: 750 -> 305 at 50,000 a year, 299 at 55,000, 73 at 400 a day, 299 at 30 an hour. |
| salary_period | optional | annual · daily · hourly | What `min_salary` is per: annual (default), daily or hourly (daily / hourly are classic-engine only). |
/totaljobs/v1/company3 creditsAn employer's Totaljobs profile: name, logo, about text, address, size, founded year, industries, sectors, benefits, open job count, whether Totaljobs files it as a direct employer or an agency, its jobs by type and place, and the first 25 of its jobs.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| company_id | optional | — | The employer's `company_id` from a search row or a job. Either `company_id` or `company` is required. |
| company | optional | — | Employer name; resolved to its id through the search box's own company suggestions (one extra 1-2 KB request). Ambiguous or unknown names return NOT_FOUND with the closest suggestions. |
/totaljobs/v1/job2 creditsThe full job ad: title, employer (with its profile when published), location with postcode and coordinates, the employer's printed salary and its parsed range, contract type and work policy (on-site / hybrid / remote), employment type, industry, posted and closing dates, full description, images, the 10 similar jobs the site shows and its related searches.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| job_id | optional | — | The `job_id` of a search row. Either `job_id` or `url` is required. |
| url | optional | — | A totaljobs.com job link (…-job<id> or /job/<id>). |
/totaljobs/v1/similar_jobs2 creditsThe 10 jobs Totaljobs recommends next to one job ad, with salary, employer, place and date.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| job_id | optional | — | The job's `job_id`. |
| url | optional | — | A job link. |
/totaljobs/v1/autocomplete1 creditThe search box's own suggestions for a few typed letters: job titles, skills and employers (with company_id) for type=keyword; towns, districts and postcodes (with city_id) for type=location.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | The letters typed so far. |
| type | optional | keyword · location | keyword (default) or location. |
| limit = 10 | optional | 1–50 | How many suggestions (the site's box asks for 5; measured 'nur': 50 asked -> 47 returned, every suggestion the service has). |
/totaljobs/v1/advice_articles2 creditsOne page of a Totaljobs career-advice topic: its articles (job-description role profiles with duties, salary and skills sections, CV, interview and pay guides …), sub-topics and the site's other article rails.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| topic = job-descriptions | optional | — | Topic slug or link (job-descriptions, engineering-job-descriptions, cvs, interviews …). |
| page = 1 | optional | 1–100 | Topic page (10-12 articles per page). |
/totaljobs/v1/advice_article2 creditsOne career-advice article in full: title, standfirst, author, published and updated dates, read time, table of contents, every section, FAQs, topics and related articles.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| article | required | — | Article slug or its totaljobs.com/advice/ link. |
/totaljobs/v1/advice_search2 creditsSearch Totaljobs' career-advice library (10 articles per page).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Words to search for. |
| page = 1 | optional | 1–100 | Result page, 10 articles each. |
curl -X POST https://api.reefapi.com/totaljobs/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"nurse","location":"Leeds"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.