Totaljobs job ads, salaries and employers for the UK
- endpoints
- 11
- credits per call
- 1–3
Totaljobs does not offer a public API for reading job ads.
/totaljobs/v1
- POST/totaljobs/v1/search1 credit
- POST/totaljobs/v1/filters1 credit
- POST/totaljobs/v1/search_by_url1 credit
- POST/totaljobs/v1/company_jobs1 credit
- POST/totaljobs/v1/company3 credits
- POST/totaljobs/v1/job2 credits
- POST/totaljobs/v1/similar_jobs2 credits
- POST/totaljobs/v1/autocomplete1 credit
- POST/totaljobs/v1/advice_articles2 credits
- POST/totaljobs/v1/advice_article2 credits
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
Get a free API keyRun the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Totaljobs API
5 of 11 endpoints, ready to run
Search Totaljobs
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Totaljobs endpoints does ReefAPI ship?
11 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
search
1 crSearch live Totaljobs (UK) job ads by keyword and location with the site's filters.
- required
- —
- optional
- query, location, radius, page, sort, search_engine, posted_within_days, min_salary, salary_period, job_type, remote, work_policy, contract_type, work_type, application_method, discipline, skill_id, category_id, sector_id, city_id, region_id, country_id
filters
1 crMarket counts for a search without the job rows.
- required
- —
- optional
- query, location, radius, search_engine, posted_within_days, min_salary, salary_period, job_type, remote, work_policy, contract_type, work_type, application_method, discipline, skill_id, category_id, sector_id, city_id, region_id, country_id
search_by_url
1 crJobs behind any totaljobs.com search or employer link (with the site's own filters in the lin…
- required
- url
- optional
- url, page
company_jobs
1 crAll open jobs of one employer on Totaljobs, 25 per page, with optional keyword, date, job-typ…
- required
- —
- optional
- company_id, company, query, page, sort, posted_within_days, job_type, remote, min_salary, salary_period
company
3 crAn employer's Totaljobs profile.
- required
- —
- optional
- company_id, company
job
2 crThe full job ad.
- required
- —
- optional
- job_id, url
similar_jobs
2 crThe 10 jobs Totaljobs recommends next to one job ad, with salary, employer, place and date.
- required
- —
- optional
- job_id, url
autocomplete
1 crThe search box's own suggestions for a few typed letters.
- required
- query
- optional
- query, type, limit
advice_articles
2 crOne page of a Totaljobs career-advice topic.
- required
- —
- optional
- topic, page
advice_article
2 crOne career-advice article in full.
- required
- article
- optional
- article
advice_search
2 crSearch Totaljobs' career-advice library (10 articles per page).
- required
- query
- optional
- query, page
Every parameter, every allowed value →
Missing a Totaljobs endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Totaljobs API works
Totaljobs is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a UK job search to the employer behind each ad
Search Totaljobs, open the ads you want, then read each employer's profile and its other open jobs.
Up to 25 jobs a page with title, employer, place, salary line and parsed range, dates and summary, plus Totaljobs' counts and the live count of every filter value.
The full ad: description, contract type, on-site / hybrid / remote, postcode and coordinates, closing date, the employer's profile and 10 similar jobs.
The employer's profile and its job counts by type and place.
Every open job of that employer, paged like search.
A dated list of UK openings with the advertised pay, and a profile of each hiring employer or agency.
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": { … },
"meta": {
"api": "totaljobs",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Totaljobs field actually contains
Fields that read differently from how they look. Each row was measured on live Totaljobs data on 2026-11-19.
| Field | What it holds |
|---|---|
| salary_text | The salary line exactly as the employer wrote it ("£500-700 per day", "Competitive", "Up to £37720.8 per annum + Up to £150 a month personal bonus"). It matched the job page on 8 of 8 ads checked. Filled on 16 to 24 of 25 rows per search. |
| salary | min, max, currency and period parsed from salary_text. Only the part before a "+" is read, so bonuses never become the salary. null when the line has no figure ("Competitive", "Negotiable"): 9 of 25 legal rows, 24 of 25 driving rows had one. "Up to" fills only max, "From" only min. Period mix differs by field: 16 of 20 warehouse rows hourly, 22 of 25 accountancy rows annual, 7 of 25 teaching rows daily. |
| total, counts, results_on_site | results_on_site is the "N jobs" headline Totaljobs prints. total also counts the nearby-area and similar-title jobs Totaljobs adds after the exact matches, and pages run over total; counts.main is the exact matches. Each row says which kind it is in match_type (main, regional, semantic). Nurse in Leeds within 20 miles: total 940, counts.main 250, results_on_site 258. |
| search_engine | classic or new. Totaljobs answers searches from two engines with different filters and different counts for the same words: python in London had 750 exact matches on classic and 679 on new. classic is the default; a filter only the new engine has switches to it. |
| date_posted, publish_to | date_posted equals the job page's own datePosted on 8 of 8 ads checked. publish_to is the date the ad is scheduled to come off; on the job page it is valid_through. |
| contract_type, work_policy | Split from the job page's own line such as "Permanent Contract; On-site" or "Temporary Contract; Hybrid"; contract_type_text keeps the whole line. |
| company.profile | The employer's Totaljobs profile when it has one: about text, address, size band, founded year, industries, benefits, images and videos. Present on 4 of 8 job ads checked. |
| address | Postcode on 5 of 8 job ads, coordinates on 7 of 8, street on 0 of 8: Totaljobs does not publish street addresses. |
Salaries are in GBP when the line carries a £ sign; a line written without one ("70-82k Annual") has currency null.
Totaljobs coverage, measured
Every number below comes from 136 live calls on 2026-11-19; every action answered all of its calls (117 of 117 positive calls).
133,302 jobs on Totaljobs on 2026-11-19. Searches for nursing, software, finance, driving, hospitality, teaching, warehouse and legal jobs in Leeds, London, Manchester, Birmingham, Glasgow, Bristol, Cardiff, Edinburgh, Belfast and Norwich each returned 20 to 25 jobs on page 1.
Python in London, 750 exact matches: last 24 hours 34, last 7 days 139; permanent 609, contract 137, part-time 64; work from home 252; at least £50,000 a year 305. Newer engine: hybrid 235, remote 34, Easy Apply 273.
On 8 job ads from 8 different searches, title, employer, employer id, salary line, place and posted date matched between the search row, the job ad and Totaljobs' own job page on 8 of 8 each.
Up to 25 jobs a page, to the last page: page 300 of 424 answered. Three pages in a row: 75 different jobs, no repeats. A full walk of a 64-job search returned all 64.
Plain names find the employer: "Tesco" resolved to TESCO Plc (1,722 jobs on its employer page). company_jobs filters inside one employer: TESCO Plc 1,636 jobs, 14 part-time, 72 from the last 7 days.
advice_articles, advice_article and advice_search read Totaljobs' advice library: role profiles such as "Sous Chef job description" with author, dates, read time, sections and FAQs.
No batch: one call per job ad. Street addresses are not published (0 of 8 ads); postcodes on 5 of 8. Totaljobs' company-type filter does not change its results, so direct-employer / agency comes back as counts only. The newer engine takes salary in steps of £10,000 and dates of 1 or 7 days. Career-advice calls take longer than job calls: 4 to 25 seconds measured.
What people build with Totaljobs
The jobs this data is most often used for.
Track new UK job ads by keyword, place and radius, newest first.
Compare advertised salaries per role and region, per year, day or hour.
Build lists of hiring employers and recruitment agencies with their open-job counts.
Watch one employer's hiring: every open job, filtered by type and date.
endpoints
credits per call
What Totaljobs data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 694 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/totaljobs/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "nurse",
"location": "Leeds"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Totaljobs.
Is there an official Totaljobs API?▾
Totaljobs has no public API for reading job ads. This API reads the public totaljobs.com pages and returns JSON; no Totaljobs account is needed.
Which search filters work?▾
Each was checked against the unfiltered count on 2026-11-19. Python jobs in London, 750 exact matches: posted in the last day 34, last 3 days 96, last 7 days 139, last 14 days 287; permanent 609, contract 137, part-time 64, work from home 199; marked work-from-home 252; at least £50,000 a year 305, £400 a day 73, £30 an hour 299. On Totaljobs' newer engine (679): hybrid 235, on-site 408, remote 34; permanent 552, temporary 120; Easy Apply 273; IT discipline 463.
How deep can I page?▾
Up to 25 jobs a page, to the last page of the search. Page 300 of 424 of a "warehouse" search returned 25 jobs. Three pages in a row returned 75 different jobs with no repeats, and walking all 3 pages of "data analyst" in Bristol returned exactly the 64 jobs Totaljobs counted. A page past the end returns NOT_FOUND.
Does it return the salary?▾
Yes: the salary line the employer wrote, and its parsed minimum, maximum, currency and period (per year, day or hour). 16 to 24 of 25 search rows per job field carried a salary line on 2026-11-19 (warehouse 19 of 20); the rest are "Competitive" or blank on Totaljobs too.
Can I search by radius?▾
Yes, in miles around a town, city or postcode. Nurse jobs around Leeds: 103 exact matches at 0 miles, 147 at 10, 250 at 20, 400 at 30, 1,884 at 100.
Can I get all jobs of one employer?▾
company_jobs takes the employer's name or id and pages through its open jobs with the same date, job-type, home-working and salary filters. TESCO Plc had 1,636 open jobs on 2026-11-19, 14 of them part-time. company returns the employer's profile and job counts.
Does it include recruiter or agency details?▾
Every job carries the advertiser Totaljobs shows (employer or recruitment agency) with its id, logo and open-job count, and its profile when it has one. Totaljobs also counts each search by direct employer and agency; that split comes back as counts.
Can I fetch many jobs at once?▾
No batch action: each job ad is its own call. A search page already returns the title, employer, place, salary line, dates and a summary for 25 jobs.
What is the Totaljobs API?▾
Totaljobs API is a ReefAPI endpoint group for uk job ads from totaljobs: search with every site filter, full ads with salary, employers and career advice. It returns live JSON through POST requests under /totaljobs/v1.
Is the Totaljobs API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Totaljobs calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Totaljobs login or account?▾
No login to Totaljobs 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 Totaljobs 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 Totaljobs API use?▾
Totaljobs actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Totaljobs from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call totaljobs actions with the same key, credit pool and JSON envelope used by normal REST requests.
32 Jobs & Hiring APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Totaljobs, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-19.