Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Totaljobs API page →
docs / totaljobs

Totaljobs

UK job ads from Totaljobs: search with every site filter, full ads with salary, employers and career advice.

base /totaljobs/v111 endpoints
post/totaljobs/v1/filters1 credit

Market 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.

ParameterAllowed / rangeDescription
queryoptional—Optional keyword. Leave both `query` and `location` empty for the whole UK board.
locationoptional—Optional town, city or postcode.
radius = 10optional0–100Distance 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_engineoptionalclassic · newWhich 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_daysoptional1 · 3 · 7 · 14Only 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_salaryoptional1–10000000Minimum 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_periodoptionalannual · daily · hourlyWhat `min_salary` is per: annual (default), daily or hourly (daily / hourly are classic-engine only).
job_typeoptionalpermanent · contract · temporary · part_time · work_from_homeClassic-engine job type. Measured python / London 750 -> permanent 609, contract 137, part_time 64, work_from_home 199, temporary 0.
remoteoptionalonly · excludeClassic-engine home-working filter: only = jobs marked work-from-home, exclude = the rest. Measured python / London 750 -> 252 (only), 497 (exclude).
work_policyoptionalon_site · hybrid · remoteNew engine. Measured python / London 679 -> on_site 408, hybrid 235, remote 34.
contract_typeoptionalpermanent · temporary · freelance · temp_staffingNew engine. Measured python / London 679 -> permanent 552, temporary 120.
work_typeoptionalfull_time · part_timeNew engine full-time / part-time. Measured python / London 679 -> full_time 9, part_time 1 (most ads do not set it).
application_methodoptionaleasy_apply · company_websiteNew engine: easy_apply = Totaljobs' own application form, company_website = apply on the employer's site. Measured 679 -> 273 / 406.
disciplineoptional—New engine discipline id from `facets.herdwickDisciplines` (e.g. IT, Engineering). Measured python / London 679 -> 463 (IT).
skill_idoptional—New engine skill id from `facets.skills` (240010 = Python). Measured 679 -> 565.
category_idoptional—New engine job-title category id from `facets.categories`. Measured 679 -> 17.
sector_idoptional—New engine sector id from `facets.sectors` (611392 = IT & Tech). Measured 679 -> 61.
city_idoptional—New engine city id from `facets.cities` (100552 = London). Measured 679 -> 670.
region_idoptional—New engine region id from `facets.regions`.
country_idoptional—New engine country id from `facets.countries` (538267 = England). Measured 679 -> 674.
Try in playground →
post/totaljobs/v1/search_by_url1 credit

Jobs behind any totaljobs.com search or employer link (with the site's own filters in the link), page by page.

ParameterAllowed / rangeDescription
urlrequired—A totaljobs.com /jobs/… search link or an employer link (/jobs-at/<name>/jobs?cmpId=… or /jobs/<name>?cmpId=…&cmp=1).
page = 1optional1–2000Result 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.
Try in playground →
post/totaljobs/v1/company_jobs1 credit

All open jobs of one employer on Totaljobs, 25 per page, with optional keyword, date, job-type, home-working and salary filters.

ParameterAllowed / rangeDescription
company_idoptional—The employer's `company_id` from a search row or a job. Either `company_id` or `company` is required.
companyoptional—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.
queryoptional—Optional keyword inside the employer's jobs.
page = 1optional1–2000Result 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.
sortoptionalrelevance · daterelevance (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_daysoptional1 · 3 · 7 · 14Only 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_typeoptionalpermanent · contract · temporary · part_time · work_from_homeClassic-engine job type. Measured python / London 750 -> permanent 609, contract 137, part_time 64, work_from_home 199, temporary 0.
remoteoptionalonly · excludeClassic-engine home-working filter: only = jobs marked work-from-home, exclude = the rest. Measured python / London 750 -> 252 (only), 497 (exclude).
min_salaryoptional1–10000000Minimum 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_periodoptionalannual · daily · hourlyWhat `min_salary` is per: annual (default), daily or hourly (daily / hourly are classic-engine only).
Try in playground →
post/totaljobs/v1/company3 credits

An 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.

ParameterAllowed / rangeDescription
company_idoptional—The employer's `company_id` from a search row or a job. Either `company_id` or `company` is required.
companyoptional—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.
Try in playground →
post/totaljobs/v1/job2 credits

The 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.

ParameterAllowed / rangeDescription
job_idoptional—The `job_id` of a search row. Either `job_id` or `url` is required.
urloptional—A totaljobs.com job link (…-job<id> or /job/<id>).
Try in playground →
post/totaljobs/v1/similar_jobs2 credits

The 10 jobs Totaljobs recommends next to one job ad, with salary, employer, place and date.

ParameterAllowed / rangeDescription
job_idoptional—The job's `job_id`.
urloptional—A job link.
Try in playground →
post/totaljobs/v1/autocomplete1 credit

The 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.

ParameterAllowed / rangeDescription
queryrequired—The letters typed so far.
typeoptionalkeyword · locationkeyword (default) or location.
limit = 10optional1–50How many suggestions (the site's box asks for 5; measured 'nur': 50 asked -> 47 returned, every suggestion the service has).
Try in playground →
post/totaljobs/v1/advice_articles2 credits

One 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.

ParameterAllowed / rangeDescription
topic = job-descriptionsoptional—Topic slug or link (job-descriptions, engineering-job-descriptions, cvs, interviews …).
page = 1optional1–100Topic page (10-12 articles per page).
Try in playground →
post/totaljobs/v1/advice_article2 credits

One career-advice article in full: title, standfirst, author, published and updated dates, read time, table of contents, every section, FAQs, topics and related articles.

ParameterAllowed / rangeDescription
articlerequired—Article slug or its totaljobs.com/advice/ link.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.