totaljobs.com APItotaljobs.com ↗
Search and retrieve UK job listings from TotalJobs by keyword, location, and radius. Access titles, salaries, company names, and full job descriptions.
curl -X GET 'https://api.parse.bot/scraper/5e28ef95-23e9-48ef-9a2a-525932d8a6ee/search_jobs?query=software+engineer&radius=10&location=London' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job listings on totaljobs.com by keyword and location. Returns paginated results with job titles, companies, locations, salaries, and snippets.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| query | string | Job title or keyword to search for |
| radius | integer | Search radius in miles from the location |
| location | string | Location to search in (e.g. 'London', 'Manchester') |
{
"type": "object",
"fields": {
"jobs": "array of job objects with keys: title, company, location, salary, posted_time, url, snippet",
"pagination": "object with keys: current_page (integer), has_next (boolean), total_results (integer or null)"
},
"sample": {
"data": {
"jobs": [
{
"url": "https://www.totaljobs.com/job/software-engineer/cisco-job107298681",
"title": "Software Engineer",
"salary": "Competitive",
"company": "Cisco",
"snippet": "Support & Growth: Receive dedicated mentorship and formal training...",
"location": "London",
"posted_time": "7 hours ago"
}
],
"pagination": {
"has_next": true,
"current_page": 1,
"total_results": 905
}
},
"status": "success"
}
}About the totaljobs.com API
The TotalJobs API gives developers access to UK job listings across two endpoints: search_jobs for querying by keyword, location, and radius, and get_job_detail for pulling full listing data. A search response returns up to 7 fields per job—title, company, location, salary, posted time, URL, and snippet—plus pagination metadata. The detail endpoint adds job type, HTML and plain-text descriptions, and a direct application URL.
Search Jobs
The search_jobs endpoint accepts a query string (job title or keyword), a location string (e.g. London or Manchester), a radius in miles, and a page integer for pagination. The response includes an array of job objects, each carrying title, company, location, salary, posted_time, url, and snippet. The pagination object reports current_page, a has_next boolean for walking through result pages, and total_results (which may be null for some queries).
Job Detail
The get_job_detail endpoint takes a single required input: the full url of a TotalJobs listing page. It returns structured fields including job_type, posted_date, apply_url, and both description_html and description_text representations of the full job description. This makes it straightforward to render formatted listings or extract plain text for further processing such as parsing skills and requirements.
Coverage and Scope
Both endpoints are scoped to TotalJobs, one of the larger UK-focused job boards. Location-based filtering relies on TotalJobs' own geographic index, so radius searches reflect how that site groups and ranks results by proximity. Salary data is returned as a string as it appears on the listing, which means it can reflect ranges, "negotiable" text, or be empty when the advertiser has not disclosed it.
- Aggregate UK job listings by keyword and city for a niche job board or newsletter
- Monitor salary strings across roles and locations to build compensation benchmarking datasets
- Pull full job descriptions via
get_job_detailto extract required skills using NLP pipelines - Track how quickly new roles appear in a specific location by comparing
posted_timeacross dailysearch_jobscalls - Feed job listing data into a recruitment CRM by syncing
company,title, andapply_urlfields - Build a job alert tool that pages through
search_jobsresults and surfaces roles matching saved criteria
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TotalJobs have an official developer API?+
What does the `search_jobs` endpoint return when salary is not disclosed?+
salary field is a string taken directly from the listing. When an employer has not disclosed pay, this field is typically empty or contains placeholder text like 'Competitive'. It is never normalised to a numeric range by this API.How does pagination work in `search_jobs`?+
pagination object in each response includes current_page, a has_next boolean indicating whether additional pages exist, and total_results which reflects the total count reported by TotalJobs (and may be null for some queries). Increment the page parameter and check has_next to walk through all results.Does the API support filtering by job type, industry sector, or contract length?+
search_jobs endpoint filters by query, location, and radius only. Job type, sector, and contract filters are not exposed as parameters. You can fork this API on Parse and revise it to add those filtering inputs.