Fahrzeugauswahl per API: Marken, Serien und Varianten in vier Schritten

Warum eine geführte Fahrzeugauswahl besser ist als Freitext

In Shop-Software, Autohaus-Tools oder Konfiguratoren steht Entwickler:innen früh eine Entscheidung bevor: Soll der Nutzer Marke und Modell frei eintippen — oder Schritt für Schritt aus gültigen Optionen wählen?

Freitext wirkt flexibel, produziert aber schnell Tippfehler, uneindeutige Treffer und Support-Fälle. Eine geführte Auswahl über die api4cars REST API liefert dagegen in jedem Schritt nur valide Optionen: zuerst die Marke, dann die Baureihe, danach die exakte Motorisierung als HSN/TSN-Paar.

Der empfohlene 4-Schritt-Flow

Für die meisten Integrationen — Felgen-Shops, Reifen-Konfiguratoren, Werkstatt-Software oder Autohaus-Frontends — ist dieser Cascade-Flow der schnellste Weg zu einer sauberen Vehicle-Picker-UI:

1. GET /brands — verfügbare Marken laden
2. GET /series — Generationen/Baureihen der gewählten Marke
3. GET /variants — alle Motorisierungen und HSN/TSN-Paare dieser Serie
4. GET /vehicle oder GET /compatibility — technische Fahrzeug- oder Felgendaten abrufen

Statt eines großen Datenexports arbeiten Sie so mit kleinen, cache-freundlichen Requests. Jeder Schritt baut logisch auf dem vorherigen auf — ideal für Dropdowns, Stepper oder modale Auswahl-Dialoge.

Schritt 1: Marken abfragen

Der Einstieg ist ein einzelner Request an /brands. Die Antwort enthält pro Marke die Anzahl verfügbarer Fahrzeuge sowie — wichtig für Felgen- und Reifen-Use-Cases — wie viele Datensätze Fitment-Daten haben.

GET https://api4cars.com/api/v1/brands?onlyWithFitments=1
X-API-Key: IHR_API_KEY
X-API-Secret: IHR_API_SECRET

Mit onlyWithFitments=1 blenden Sie Marken ohne Freigabe-Daten aus. Das ist besonders sinnvoll, wenn Ihr UI ausschließlich kompatible Felgen oder Reifen anzeigen soll.

Schritt 2: Serien und Generationen laden

Sobald der Nutzer eine Marke gewählt hat, fragen Sie die passenden Baureihen ab:

GET https://api4cars.com/api/v1/series?brand=VW&onlyWithFitments=1
X-API-Key: IHR_API_KEY
X-API-Secret: IHR_API_SECRET

Die API liefert strukturierte Serienobjekte mit Generationscode, Modellfamilie und Bauzeitraum — zum Beispiel Touareg (CR) (07/18 – 05/23). Dieses Format eignet sich direkt als Label in der UI, ohne dass Sie Seriennamen selbst parsen müssen.

Schritt 3: Exakte Variante per HSN/TSN bestimmen

Im dritten Schritt reduzieren Sie die Auswahl auf die konkrete Motorisierung. Der series-Parameter muss URL-kodiert aus der vorherigen Antwort übernommen werden:

GET https://api4cars.com/api/v1/variants?brand=VW&series=Touareg+(CR)+(07%2F18+-+05%2F23)
X-API-Key: IHR_API_KEY
X-API-Secret: IHR_API_SECRET

Jede Variante enthält ein stabiles id-Feld im Format HSN_TSN, die Schlüsselnummern selbst sowie Metadaten wie Motorbezeichnung, Leistung und Getriebe. Varianten mit vorhandenen Fitment-Daten werden automatisch priorisiert — so landen Nutzer schneller bei Ergebnissen, die wirklich kompatibel sind.

Schritt 4: Fahrzeug- oder Kompatibilitätsdaten abrufen

Mit dem gewählten HSN/TSN-Paar holen Sie die Detaildaten:

GET https://api4cars.com/api/v1/vehicle?hsn=0603&tsn=COB
X-API-Key: IHR_API_KEY
X-API-Secret: IHR_API_SECRET

Für Felgen- und Reifen-Shops folgt typischerweise ein Call an /compatibility, der Freigaben, Lochkreis, Einpresstiefe und passende Reifengrößen liefert. Beide Endpoints nutzen dieselben HSN/TSN-Werte — einmal gewählt, durchgängig verwendbar.

Typische Anwendungsfälle

Felgen- und Reifen-Shops

Marken → Serie → Variante → Kompatibilitätsdaten. Der Flow verhindert, dass Kunden Produkte für das falsche Modell sehen, und reduziert Retouren durch Fehlbestellungen.

Autohäuser und Gebrauchtwagen-Portale

Statt manueller Dateneingabe wählen Verkäufer oder Endkunden das Fahrzeug strukturiert aus. Technische Eckdaten wie Leistung, Hubraum und Antrieb werden anschließend automatisch befüllt.

Werkstatt- und Flottensoftware

Beim Anlegen eines Fahrzeugdatensatzes reichen wenige API-Calls, um Marke, Modell, Motorisierung und HSN/TSN konsistent zu erfassen — ohne Medienbrüche zwischen UI und Stammdaten.

Integrationstipps für Entwickler

• Serien-Strings nicht manuell bauen — immer den exakten Wert aus /series übernehmen und URL-encoden
• Fitments früh filtern — onlyWithFitments=1 spart leere Auswahllisten in Felgen-Use-Cases
• Responses cachen — Markenlisten und Serien ändern sich selten; client- oder serverseitiges Caching reduziert Latenz spürbar
• Fehlerfreundliche UI — wenn eine Serie keine Varianten liefert, dem Nutzer eine Alternative anbieten statt den Flow abzubrechen

Fazit

Eine saubere Fahrzeugauswahl per API ist kein Luxus, sondern die Grundlage für verlässliche Automotive-Software. Mit /brands, /series, /variants und anschließend /vehicle oder /compatibility bauen Sie in wenigen Schritten einen Picker, der skaliert, wartbar bleibt und Ihre Nutzer sicher zum richtigen Fahrzeug führt.

Alle Endpoints, Parameter und Beispiel-Responses finden Sie in der api4cars API-Dokumentation. Zum Testen steht der Free Plan mit 50 Requests pro Monat ohne Kreditkarte zur Verfügung.