{"uid":"cap_0YuJ0CKTfKN5bts_sR3Pv","slug":"totaljobs-uk-job-listings-scraper-a819363d","name":"TotalJobs UK Job Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/totaljobs?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["relevance","date","salaryLow","salaryHigh","distance"],"type":"string","default":"relevance","description":"Order shown by the public search page."},"query":{"type":"string","description":"Job title or search phrase. Required when Start URLs is empty."},"radius":{"type":"integer","minimum":1,"description":"Distance from the location; only applies when Location is set."},"jobType":{"enum":["","permanent","contract","part-time","temporary","work-from-home"],"type":"string","default":"","description":"Public job category path used to narrow the search."},"location":{"type":"string","description":"UK town, city, or region to add to the search path."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many unique jobs. Set 0 for no item cap."},"maxPages":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Maximum pages to visit for each search URL. Each page normally has 25 jobs."},"minSalary":{"type":"integer","minimum":0,"description":"Annual salary threshold in GBP."},"startUrls":{"type":"array","description":"Search result or individual job URLs. Overrides the keyword search."},"postedWithin":{"type":"integer","minimum":1,"description":"Show listings posted within this many days."},"includeDetails":{"type":"boolean","default":false,"description":"Fetch each job page for the full description, salary, employment type, and location coordinates."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"title":null,"jobKey":null,"company":null,"location":null,"postCode":null,"companyId":null,"companyUrl":null,"companyLogoUrl":null}],"product":"totaljobs"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.028","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.028/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.028","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.028","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2fqTMz8Z-RvZod49_eNIF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.028","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured job listing data from TotalJobs.com including titles, companies, locations, and salary details based on keyword search or direct URLs","exampleAgentPrompt":"Search TotalJobs for software engineer jobs in London, permanent roles only, posted within the last 14 days, sorted by date, and pull up to 50 listings with full details including salary and job description.","exampleUseCases":[{"title":"Tech recruitment market research","prompt":"Pull me up to 100 data analyst job listings from TotalJobs in Manchester, sorted by salary high to low, posted within the last 30 days — I need the company, location, and salary info for each one."},{"title":"Remote job opportunity monitoring","prompt":"Search TotalJobs for work-from-home customer service jobs, grab the first 5 pages of results sorted by relevance, and include full details so I can see the salary ranges and employment types."},{"title":"Targeted contract role search","prompt":"Find contract software developer roles on TotalJobs within 25 miles of Leeds with a minimum salary of 50000 GBP, posted in the last 7 days, and return up to 75 listings sorted by date."}],"resultDescription":"Returns a JSON object containing a count of results and an array of job items, each with fields for job title, job key, company name, location, post code, company ID, company URL, and company logo URL. When includeDetails is true, also returns full job description, salary, employment type, and location coordinates.","failureModes":["Empty result set if query matches no live listings — not charged","TotalJobs site structure changes breaking extraction","Invalid enum value for sort or jobType returns validation error","maxPages exceeding 100 rejected by schema","Radius set without location has no effect","Rate limiting or blocking by TotalJobs if volume is very high"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable job listing data from TotalJobs.com specifically — particularly for UK-focused job searches. Prefer it over generic web scrapers when you want pre-parsed fields like company, salary, and location without building your own extraction logic. It is well-suited for recruitment research, job market analysis, or automated job monitoring workflows targeting the UK market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:08.898Z","isFirstParty":false,"canonicalSlug":"totaljobs-uk-job-listings-scraper-a819363d"}