Ausbildung.de Vocational Training Scraper

Scrape German apprenticeship (Ausbildung) job listings from ausbildung.de — one of Germany's largest vocational-training job boards. Search open apprenticeship positions by city and industry category, look up nationwide listings for a specific profession, or run a free-text keyword search across all professions and employers nationwide. Get titles, employer names, locations, start dates, school-diploma requirements, apprenticeship type, and application details. No auth, no proxy, no cookies required.

What this actor does

• Three modes: byCity (city + broad category browse), byProfession (nationwide lookup for one specific occupation), and byQuery (free-text keyword search nationwide, matching partial profession/employer names)
• Any German city: works with any city ausbildung.de indexes (Berlin, München, Hamburg, Köln, and thousands of smaller towns)
• ~700 professions: from fachinformatiker to altenpfleger to bankkaufmann
• Filters: required school diploma, apprenticeship type, training start-date range, minimum open positions, keyword, direct-application-only, top-rated-employer-only
• Optional deep enrichment: fetch each listing's detail page for the full job description, employer contact/website, and address
• Empty fields are omitted

Output per listing

• vacancyId, jobPostingId — ausbildung.de internal IDs
• title, professionTitle — the specific posting title and the standardized occupation name
• corporationName, subsidiaryName — hiring company
• location, city, postalCode — parsed from the raw location string
• vacancyCount — number of open positions in this posting
• relatedBranchesCount — number of other company locations also offering this posting
• startsNoEarlierThan, validUntil — training start date and posting expiry
• expectedGraduation — required school-leaving diploma
• apprenticeshipType — dual apprenticeship / school-based / dual-study / etc.
• duration — training length
• applicationOptions, directApplicationOn — how to apply
• corporationLogo, subsidiaryLogo — employer logo image URLs
• inSpotlight, topRatedEmployer — ausbildung.de curation flags
• corporationRecentReviewCount, corporationRecentStarCountAvg — employer rating (when reviews exist)
• listingUrl / sourceUrl — canonical ausbildung.de detail page
• With includeJobDescription: true, also: description (full plain-text job ad), employmentType, datePosted, employerWebsite, streetAddress, addressLocality, addressRegion, addressCountry, industry, educationRequirements, jobImage
• recordType: "apprenticeshipListing", scrapedAt

Input

Field	Type	Default	Description
mode	string	byCity	byCity, byProfession, or byQuery
citySlug	string	berlin	City name (mode=byCity). Umlauts auto-normalized.
category	select	kaufmaennisch	Broad industry/topic filter (mode=byCity)
professionSlug	string	fachinformatiker	Exact profession slug (mode=byProfession), nationwide
searchQuery	string	Fachinformatiker	Free-text keyword (mode=byQuery), nationwide — matches partial profession/employer names
expectedGraduation	select	–	Required school diploma
apprenticeshipType	select	–	Dual / school-based / dual-study / etc.
startDateFrom / startDateTo	string	–	Only keep listings whose training start date (YYYY-MM-DD) falls in this range
minVacancyCount	int	0	Drop listings with fewer open positions
keyword	string	–	Substring match on title/profession/company
directApplicationOnly	bool	false	Only listings with direct online application
topRatedEmployerOnly	bool	false	Only ausbildung.de-flagged top employers
includeJobDescription	bool	false	Fetch full description + contact details per listing (slower)
maxItems	int	20	Hard cap (1–300). The actor pages through results (~20/page for city searches, ~3/page for narrow profession searches) until the cap is reached or the source pool is exhausted.

Example: IT apprenticeships in Berlin

{
  "mode": "byCity",
  "citySlug": "berlin",
  "category": "it",
  "maxItems": 20
}

Example: nationwide search for a specific profession, with full descriptions

{
  "mode": "byProfession",
  "professionSlug": "mechatroniker",
  "includeJobDescription": true,
  "maxItems": 10
}

Example: top-rated employers offering Abitur-level training in Hamburg

{
  "mode": "byCity",
  "citySlug": "hamburg",
  "category": "kaufmaennisch",
  "expectedGraduation": "abitur",
  "topRatedEmployerOnly": true
}

Example: nationwide keyword search for an employer

{
  "mode": "byQuery",
  "searchQuery": "McDonald's",
  "maxItems": 20
}

Use cases

• Career counseling platforms — surface current openings by region and field
• Vocational-training research — track apprenticeship supply across German cities/industries
• Recruiting intelligence — monitor which employers post the most apprenticeship openings
• Education-tech aggregators — build a searchable apprenticeship index
• Labor-market analysis — measure apprenticeship demand per profession and diploma level

Limitations

• The actor pages through ausbildung.de's server-rendered results (via ?page=N) up to 25 pages, stopping early once several consecutive pages yield no new listings — this handles ausbildung.de's pool-recycling behavior for narrow queries (e.g. rare profession + city combos) without looping forever. Very broad queries may still not reach maxItems if the underlying pool is smaller than requested.
• City + specific-profession combinations (e.g. "altenpfleger in Berlin") are not directly filterable — use mode=byCity with a broad category, or mode=byProfession for nationwide profession-only results.
• Company-directory browsing and German-state-level (Bundesland) listing pages are navigation-only on ausbildung.de (they link out to individual cities) and are not exposed as a separate mode.

FAQ

What's ausbildung.de? A German job board run by Studitemps GmbH dedicated to Ausbildung (vocational apprenticeship) and dual-study openings across all industries and regions in Germany.

What does "category" mean in byCity mode? A broad topic filter ausbildung.de itself curates per city — industries (it, handwerk, medien), required diploma (abitur, hauptschulabschluss), or specific popular occupations. Not every category has listings in every city; an empty result for a rare combination is expected, not an error.

How do I find valid professionSlug values? Browse ausbildung.de/berufe/glossar/ for the full alphabetical list of ~700 professions. Common examples: fachinformatiker, kauffrau-im-einzelhandel, mechatroniker, altenpfleger, bankkaufmann, koch, elektroniker-betriebstechnik.

Why do some listings lack a postalCode? ausbildung.de sometimes shows only the city name (e.g. "Berlin") without a postal code for postings that cover multiple locations within a region.

Why does a valid-looking professionSlug sometimes return 0 listings? A handful of glossary entries describe occupations that have been superseded or merged into newer training paths (e.g. the legacy altenpfleger title was folded into the unified pflegefachmann qualification after Germany's 2020 nursing-education reform) or are university-track roles ausbildung.de lists for reference only (e.g. arzt, apotheker). These pages exist but currently carry no active apprenticeship postings — 0 records is the correct, real-time answer, not a scraper bug.

Is proxy or login required? No. The actor reads ausbildung.de's public, server-rendered pages directly.

How fresh is the data? Real-time — the actor reads the same server-rendered page a browser visitor would see at request time.