civilservicejobs.service.gov.uk APIcivilservicejobs.service.gov.uk ↗
Search and retrieve UK Civil Service job listings by keyword, location, and grade. Access titles, salaries, departments, closing dates, and full vacancy details.
curl -X GET 'https://api.parse.bot/scraper/d7734b85-2dcc-4952-b455-218ca45215cb/search_jobs?page=1&query=data+analyst' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job listings by keyword and/or location. Returns a paginated list of jobs with titles, departments, locations, salaries, closing dates, and reference numbers.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| query | string | Search keyword (job title, skill, or keywords). Leave empty to browse all jobs. |
| location | string | Location filter (postcode, town, or region) |
{
"type": "object",
"fields": {
"jobs": "array of job objects with title, url, jcode, department, location, salary, and closing_date",
"total_count": "integer - total number of matching jobs"
},
"sample": {
"data": {
"jobs": [
{
"url": "https://www.civilservicejobs.service.gov.uk/csr/index.cgi?SID=...",
"jcode": "460847",
"title": "Data Analyst",
"salary": "£36,735 to £37,644",
"location": "Manchester",
"department": "Government Digital Service",
"closing_date": "11:55 pm on Sunday 24th May 2026"
}
],
"total_count": 10
},
"status": "success"
}
}About the civilservicejobs.service.gov.uk API
The Civil Service Jobs API provides 2 endpoints to search and retrieve UK public sector vacancies from civilservicejobs.service.gov.uk. The search_jobs endpoint returns paginated job listings with titles, departments, salaries, locations, and closing dates, while get_job_details returns full vacancy information including civil service grade, security requirements, benefits, and a job summary for a specific listing identified by its reference number.
Searching Jobs
The search_jobs endpoint accepts a query string (job title, skill, or keyword), a location filter (postcode, town, or region), and a page integer for pagination. Leaving query empty returns all current listings. Each result in the jobs array includes title, url, jcode (the vacancy reference number), department, location, salary, and closing_date. The total_count field indicates how many vacancies matched the search, which is useful for building pagination logic.
Retrieving Full Vacancy Details
The get_job_details endpoint takes a single required input — jcode — taken directly from a search_jobs result. It returns the complete vacancy record: title, salary, benefits, location, department, job_grade (the Civil Service pay band or grade), security (security clearance level required), job_summary (the full descriptive text of the role), and closing_date. This is the primary endpoint for building a job detail page or extracting structured requirements from a listing.
Coverage and Scope
All data reflects current live vacancies on the Civil Service Jobs board, which spans departments, agencies, and arm's-length bodies across the UK government. Listings include central government roles, HMRC, DVLA, the Home Office, and many others. The location filter supports standard UK location strings, and results are UK-only given the nature of the source.
- Aggregate UK public sector job listings filtered by region or keyword for a government careers portal
- Monitor closing dates on civil service vacancies to trigger alerts before application deadlines
- Extract job_grade and salary fields to analyse pay band distribution across departments
- Pull department and location data to map civil service hiring activity by region
- Build a job recommendation feed by querying search_jobs with role-specific keywords
- Track vacancy counts over time by storing total_count responses from repeated searches
- Display full vacancy descriptions and security clearance requirements in a third-party HR tool using get_job_details
| 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.