ausbildung.de APIausbildung.de ↗
Search German apprenticeship listings, get job details, browse professions A-Z, and retrieve year-by-year training salary data from ausbildung.de.
curl -X GET 'https://api.parse.bot/scraper/ff4c0507-56d1-480f-a4b9-fa5925c5d6fe/search_listings?query=Koch&location=Berlin' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for apprenticeship/training positions by keyword, location, and radius. Returns paginated results with up to 20 listings per page.
| Param | Type | Description |
|---|---|---|
| from | integer | Offset for pagination (increments of 20) |
| query | string | Search keyword (profession or company name) |
| radius | integer | Search radius in km |
| location | string | City name or postal code to search near |
{
"type": "object",
"fields": {
"from": "integer offset used",
"listings": "array of listing objects with id, title, company, location, profession, start_date, apprenticeship_type, duration, slug, url",
"total_count": "integer total number of matching vacancies",
"results_count": "integer number of results returned on this page"
},
"sample": {
"data": {
"from": 0,
"listings": [
{
"id": "3c7a68d1-1ab1-4ef6-b78d-213efd5019d5",
"url": "https://www.ausbildung.de/stellen/ausbildung-koch-koechin-m-w-d-ab-august-2024-bei-park-inn-by-radisson-berlin-alexanderplatz-in-berlin-3c7a68d1-1ab1-4ef6-b78d-213efd5019d5/",
"slug": "ausbildung-koch-koechin-m-w-d-ab-august-2024-bei-park-inn-by-radisson-berlin-alexanderplatz-in-berlin-3c7a68d1-1ab1-4ef6-b78d-213efd5019d5",
"title": "Ausbildung Koch/Köchin (m/w/d) ab August 2026",
"company": "Park Inn by Radisson Berlin Alexanderplatz",
"duration": "3 Jahre",
"location": "10178 Berlin",
"profession": "Koch/Köchin",
"start_date": "2026-08-01",
"apprenticeship_type": "klassische-duale-berufsausbildung"
}
],
"total_count": 7,
"results_count": 5
},
"status": "success"
}
}About the ausbildung.de API
The ausbildung.de API exposes 5 endpoints covering apprenticeship listings, profession catalogs, and salary breakdowns from Germany's apprenticeship platform. Use search_listings to query vacancies by keyword, location, and radius, then pull full posting details — including contact emails, HTML descriptions, and structured address data — with get_listing_detail. Salary data is available both at the profession overview level and as a year-by-year training compensation breakdown.
Search and Listing Endpoints
search_listings accepts a query string (profession name or company), a location (city name or postal code), and an optional radius in kilometers. Results are paginated in increments of 20 via the from offset parameter. Each listing object in the response includes an id, title, company, location, profession, start_date, apprenticeship_type, duration, and a slug used to retrieve full details. The total_count field tells you how many vacancies match so you can paginate through the full result set.
get_listing_detail takes a slug from search results and returns the complete posting: a full HTML description, a structured location object with addressLocality, postalCode, streetAddress, addressRegion, and addressCountry, an array of contact emails, date_posted, valid_through, and employment_type. This is the endpoint to use when building job detail pages or extracting contact information.
Profession Catalog
list_all_professions returns the complete A-Z directory of recognized German apprenticeship careers — each with a name, slug, and url. Slugs from this endpoint feed directly into get_profession_detail and get_profession_salary. get_profession_detail returns a description, a salary object following the MonetaryAmountDistribution schema (minValue, maxValue, currency, unitText), a rating, and a review_count.
Salary Data
get_profession_salary provides training compensation broken down by year. The salary_years object contains keys like year_1, year_2, and year_3, each holding a salary range string. A json_ld_salary object with structured MonetaryAmountDistribution data is also returned when available. This makes it straightforward to compare progression of training wages across professions.
- Aggregate German apprenticeship vacancies by city or region using search_listings with location and radius filters
- Build a job alert system that monitors new postings and extracts contact emails from get_listing_detail
- Populate a profession explorer with descriptions, ratings, and salary ranges from get_profession_detail
- Visualize year-over-year training salary progression across multiple professions using get_profession_salary
- Create a searchable A-Z directory of recognized German apprenticeship careers from list_all_professions
- Compare minimum and maximum training salaries across professions using MonetaryAmountDistribution data
- Enrich HR or recruiting tools with structured address data and employment type from listing detail responses
| 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 ausbildung.de have an official developer API?+
What does get_listing_detail return beyond what search_listings shows?+
How does pagination work in search_listings?+
from parameter as an offset — set it to 0 for the first page, 20 for the second, 40 for the third, and so on. The total_count field in the response tells you the total number of matching vacancies so you can calculate how many pages exist.Does the API return user reviews or ratings for individual companies?+
Is salary data available for every profession?+
salary field in get_profession_detail and the json_ld_salary field in get_profession_salary are returned as null when structured salary data is not present for a given profession slug. The salary_years object may also have fewer keys if the training program is shorter than three years. Coverage depends on what ausbildung.de publishes for each profession.