findapprenticeship.service.gov.uk APIfindapprenticeship.service.gov.uk ↗
Search and retrieve live UK apprenticeship vacancies from findapprenticeship.service.gov.uk. Filter by location, level, category, and more across 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/29d077ec-2cda-42fc-9194-e7cd0737aa6d/search_apprenticeships?sort=AgeAsc&distance=10&location=London&search_term=Engineering' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for apprenticeship vacancies with filters for keyword, location, distance, levels, categories, and more. Returns paginated results sorted by the specified criteria.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort option: AgeAsc (New), ClosingAsc (Closing soon), SalaryDesc (Wage), ExpectedStartDateAsc (Start date). |
| distance | string | Radius in miles: 2, 5, 10, 15, 20, 30, 40, or 'all' for across England. |
| location | string | City or postcode to search near. |
| level_ids | string | Comma-separated apprenticeship level IDs: 2, 3, 4, 5, 6, 7. |
| route_ids | string | Comma-separated job category IDs: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. |
| page_number | integer | Page number of results. |
| search_term | string | Job title or company name to search for. |
| exclude_national | boolean | Hide companies recruiting nationally. |
| apprenticeship_types | string | Comma-separated types: Foundation, Standard. |
| disability_confident | boolean | Only show disability confident companies. |
{
"type": "object",
"fields": {
"results": "array of apprenticeship vacancy summaries with vacancyReference, title, employer, location, url, startDate, trainingCourse, wage, closingDate, postedDate",
"pagination": "object with currentPage, totalResults, resultsPerPage"
},
"sample": {
"data": {
"results": [
{
"url": "https://www.findapprenticeship.service.gov.uk/apprenticeship/VAC2000031853",
"wage": "£15,808 a year",
"title": "Sales Administrator Apprentice",
"employer": "SHIELD ENGINEERING (SYSTON) LTD",
"location": "LEICESTER (LE7 1NL)",
"startDate": "3 August 2026",
"postedDate": "14 May 2026",
"closingDate": "Closes in 30 days (Saturday 13 June 2026 at 11:59pm)",
"trainingCourse": "Business administrator (level 3)",
"vacancyReference": "VAC2000031853"
}
],
"pagination": {
"currentPage": 1,
"totalResults": 377,
"resultsPerPage": 10
}
},
"status": "success"
}
}About the findapprenticeship.service.gov.uk API
This API provides access to live apprenticeship vacancies from the UK government's Find an Apprenticeship service across 4 endpoints. Use search_apprenticeships to filter vacancies by keyword, location, distance, level, and job category, then call get_apprenticeship_detail to retrieve full vacancy data including skills required, wage, hours, duration, training provider, and closing date.
Search and Filter Vacancies
The search_apprenticeships endpoint accepts parameters including search_term (job title or company name), location (city or postcode), distance (radius in miles or all for England-wide), level_ids (levels 2–7), and route_ids (job category IDs 1–15). Results return paginated vacancy summaries covering vacancyReference, title, employer, location, url, startDate, trainingCourse, and wage. Sorting is controlled via the sort parameter, with options for newest, closing soon, highest wage, or earliest start date.
Vacancy Detail
Passing a vacancy_ref (e.g. VAC2000031853) to get_apprenticeship_detail returns the full record for a single vacancy: skills array, duration, hours, start_date, closingDate, wage, location with postcode, and employer name. This is the endpoint to use when building a detail view or ingesting structured data about a specific position.
Filter Metadata and Listing Counts
get_search_filters returns the complete set of valid filter values — apprenticeship levels with descriptions, job category routes, distance radius options, sort options, and apprenticeship types — useful for populating UI filter controls or validating parameters before making search calls. get_total_listing_count returns a single integer (totalListings) reflecting the current number of live vacancies on the service, suitable for dashboards or freshness checks.
- Build a job board aggregating UK apprenticeship vacancies filtered by region and sector using
search_apprenticeshipswithlocationandroute_ids. - Send daily alerts for new apprenticeships in a specific trade by sorting with
AgeAscand filtering bylevel_idsandlocation. - Populate a career guidance tool with structured vacancy data including
skills,duration, andwagefromget_apprenticeship_detail. - Track the total volume of live UK apprenticeship listings over time using
get_total_listing_count. - Render dynamic filter dropdowns in a custom search UI by loading valid values from
get_search_filtersat startup. - Analyse apprenticeship availability by level and category across England by iterating
search_apprenticeshipswithdistanceset toall.
| 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 findapprenticeship.service.gov.uk have an official developer API?+
What does `get_apprenticeship_detail` return beyond the search summary?+
skills array listing required competencies, duration of the apprenticeship, hours description, start_date, closingDate, and location with a full postcode. It requires a vacancy_ref value (e.g. VAC2000031853), which is included in each record returned by search_apprenticeships.Is coverage limited to England, or does it include Scotland, Wales, and Northern Ireland?+
distance parameter accepts all for England-wide results but does not extend to devolved nations, which operate separate apprenticeship schemes. If you need UK-wide coverage, you can fork this API on Parse and revise it to add endpoints targeting the relevant Welsh, Scottish, or Northern Irish services.Does the API return employer contact details or application links?+
url pointing to the official listing page, along with employer name and location. Direct employer contact details such as email addresses or phone numbers are not currently returned. You can fork this API on Parse and revise it to add an endpoint that captures any additional contact fields exposed on the detail page.How should I paginate through large result sets?+
search_apprenticeships endpoint returns a pagination object containing currentPage, totalResults, and resultsPerPage. Increment the page_number input on successive calls until you have covered all pages. totalResults divided by resultsPerPage gives the page count needed.