API Dokumentation & Endpoints

Referenz

API Dokumentation

Unsere REST‑API liefert Zugriff auf über 30.000 Fahrzeuge. Basis‑URL: https://api4cars.com/wp-json/carapi/v1/

Authentifizierung

Die API erfordert zwingend eine Authentifizierung via API Key + API Secret. Deine Credentials findest du nach der Registrierung auf deiner Account-Seite.

Methode 1: Custom Headers (empfohlen)

curl -H "X-API-Key: carapi_live_xxxx" \
     -H "X-API-Secret: dein_secret_hier" \
     https://api4cars.com/wp-json/carapi/v1/brands

Methode 2: Bearer Token

curl -H "Authorization: Bearer carapi_live_xxxx:dein_secret_hier" \
     https://api4cars.com/wp-json/carapi/v1/brands

Fehlerhafte Authentifizierung

Code	Bedeutung
`401`	Fehlende, ungültige API-Credentials
`403`	Abonnement nicht aktiv

Hinweis: Schreibende Endpunkte (Import, Clear) sind zusätzlich über WordPress-Admin geschützt.

GET /brands

Gibt alle Fahrzeughersteller mit Fahrzeuganzahl und Logo-URL zurück.

Response (200)

[
  {
    "brand": "Audi",
    "count": 1826,
    "logo_url": "https://api4cars.com/wp-content/uploads/brand-logos/audi.jpeg"
  },
  {
    "brand": "BMW",
    "count": 2120,
    "logo_url": "https://api4cars.com/wp-content/uploads/brand-logos/bmw.jpeg"
  }
]

GET /models?brand=BMW

Listet alle Modellnamen einer Marke auf (alphabetisch sortiert).

Parameter	Typ	Beschreibung
`brand` *	String	Exakter Name des Herstellers (case-sensitive)

Response (200)

[
  "1er",
  "2er",
  "3er",
  "M3"
]

GET /types?brand=BMW&model=3er-Reihe

Gibt alle Typen / Baureihen für eine Marke + Modell-Kombination zurück.

Parameter	Typ	Beschreibung
`brand` *	String	Name des Herstellers
`model` *	String	Name des Modells

Response (200)

[
  "3er-Reihe E90/E91/E92/E93",
  "3er-Reihe F30/F31/F80",
  "3er-Reihe G20/G21/G80"
]

GET /motors?brand=BMW&model=3er-Reihe&type=3er-Reihe+G20

Gibt alle Motorisierungen für eine Marke/Modell-Kombination zurück, optional gefiltert nach Typ. Jeder Eintrag enthält HSN/TSN als direkten Lookup-Key.

Parameter	Typ	Beschreibung
`brand` *	String	Name des Herstellers
`model` *	String	Name des Modells
`type`	String	Optional: Typ/Baureihe zur weiteren Filterung

Response (200)

[
  {
    "hsn": "0005",
    "tsn": "CNA",
    "label": "320i (184 PS / 135 kW) | 1998 ccm | 2019-2022"
  },
  {
    "hsn": "0005",
    "tsn": "CNB",
    "label": "330i (258 PS / 190 kW) | 2998 ccm | 2019-2022"
  }
]

GET /vehicle?hsn=0603&tsn=COB

Gibt ein einzelnes Fahrzeug über HSN & TSN zurück.

Parameter	Typ	Beschreibung
`hsn` *	String (4)	Herstellerschlüsselnummer
`tsn` *	String (3)	Typschlüsselnummer

Response (200)

{
  "hsn": "0603",
  "tsn": "COB",
  "brand": "Volkswagen",
  "brand_logo": "https://api4cars.com/wp-content/uploads/brand-logos/vw.jpeg",
  "model": "SUV - CR",
  "years": "seit 2023",
  "source": "fahrzeugdaten",
  "display_vehicle": {
    "brand": "Volkswagen",
    "model": "Tiguan",
    "trim": "2.0 TDI",
    "type": "SUV",
    "series": "Tiguan (CR)",
    "series_code": "CR",
    "years": "seit 2023",
    "drivetrain": "Allradantrieb",
    "transmission": "Automatikgetriebe"
  },
  "wheels": {
    "pcd": "5x112",
    "bore": "66.6",
    "fastening": "Schraube",
    "thread": "M14x1,5",
    "torque": "120 Nm"
  },
  "vehicle_data": {
    "Typ": "SUV - CR",
    "Leistung": "170 kW / 231 PS",
    "Hubraum": "2967 ccm",
    "Kraftstoff": "Diesel",
    "Getriebe": "Automatikgetriebe",
    "Antriebsachse": "Allradantrieb",
    "Eigengewicht": "2122 kg"
  },
  "meta_flags": null,
  "updated_at": "2026-03-04 10:00:00"
}

display_vehicle Objekt

Angereicherte Anzeigeinformationen. Enthält saubere Marken-, Modell- und Typbezeichnungen, ideal für Frontend-Darstellungen. Kann null sein, wenn keine erweiterten Daten vorliegen.

GET /vehicles?brand=BMW&model=3er

Gibt eine gefilterte Liste von Fahrzeugen zurück. Mindestens einer der Filter brand, model oder pcd ist Pflicht.

Parameter	Typ	Beschreibung
`brand`	String	Herstellername (exakt)
`model`	String	Modellname (Teilstring-Suche)
`pcd`	String	Lochkreis, z.B. `5x112`
`page`	Integer	Seite (Standard: 1)
`per_page`	Integer	Ergebnisse pro Seite (Standard: 50, max: 200)

Response (200)

{
  "total": 148,
  "page": 1,
  "per_page": 50,
  "vehicles": [ /* Array von Fahrzeugobjekten, gleiche Struktur wie /vehicle */ ]
}

GET /fitments?hsn=1313&tsn=ABK

Liefert alle Aftermarket-Felgengutachten für ein Fahrzeug.

Parameter	Typ	Beschreibung
`hsn` *	String (4)	Herstellerschlüsselnummer
`tsn` *	String (3)	Typschlüsselnummer
`wheel_code`	String	Filter auf bestimmten Felgen-Code (z.B. `AF18`)
`et`	String	Filter auf Einpresstiefe
`pcd`	String	Filter auf Lochkreis
`tire_size`	String	Filter auf Reifengröße
`min_confidence`	Integer	Mindest-Confidence-Score (Standard: 0)

Response (200)

{
  "hsn": "1313",
  "tsn": "ABK",
  "count": 12,
  "exact_count": 8,
  "wildcard_count": 4,
  "filtered_wildcard": 2,
  "vehicle_pcd": "5x112",
  "vehicle_bore": "66.6",
  "fitments": [
    {
      "wheel_code": "AF18",
      "et": "21",
      "pcd": "5x112",
      "bore": "66.6",
      "confidence": 1.0,
      "approved_tires": [
        { "s": "255/40R22", "axle": "both", "codes": ["F24", "F40"] }
      ],
      "auflagen": {
        "F24": "Radschrauben M14x1,5x38 verwenden. Anzugsdrehmoment 120 Nm.",
        "F40": "RDKS nach Umrüstung neu anlernen."
      },
      "source_gutachten": "AF18_10x22_5x112.pdf",
      "is_wildcard": false
    }
  ]
}

GET /compatibility?hsn=1313&tsn=ABK

Der umfangreichste Endpunkt — kombiniert Fahrzeugdaten, Display-Informationen und alle Felgen-/Reifenfreigaben in einer einzigen Antwort. Ideal für fertige Shop-Integrationen.

Parameter	Typ	Beschreibung
`hsn` *	String (4)	Herstellerschlüsselnummer
`tsn` *	String (3)	Typschlüsselnummer

Response-Felder (200)

Feld	Typ	Beschreibung
`vehicle`	Object	Vollständiges Fahrzeugobjekt (gleich wie `/vehicle`, inkl. `display_vehicle`)
`vehicle_known`	Boolean	Ob das Fahrzeug in der Datenbank bekannt ist
`fitment_known`	Boolean	Ob Felgengutachten für dieses Fahrzeug vorliegen
`match_scope`	String	`pair_exact` \| `pcd_bore_fallback` \| `no_fitment`
`display_vehicle`	Object	Angereichertes Anzeigeobjekt (brand, model, trim, type, series_code, years, label)
`display_variants`	Array	Alle verfügbaren Fahrzeugvarianten zur Modellauswahl
`model_selection_available`	Boolean	Ob mehrere Varianten zur Auswahl stehen (`display_variants.length > 1`)
`wheel_specs`	Object	PCD & Zentrierbohrung des Fahrzeugs
`allowed_wheels`	Array	Alle freigegebenen Felgen mit Code, Breite, Durchmesser, ET, PCD, Bore
`allowed_tires`	Array	Alle freigegebenen Reifengrößen
`wheel_groups`	Array	Felgen gruppiert nach Code+Dimension, mit allen ET-Varianten
`rules`	Array	Alle Freigabe-Regeln inkl. Auflagen-Codes und Klartext
`meta`	Object	Statistik: fitment_count, exact_count, wildcard_count

GET /taxonomy

Gibt die vollständige Fahrzeughierarchie als Baum zurück: Brand → Model → Type → Engine. Ideal für mehrstufige Modellfilter-Dropdowns. Ergebnis wird 24h gecacht.

Response (200) — Struktur

[
  {
    "brand": "BMW",
    "logo": "https://api4cars.com/wp-content/uploads/brand-logos/bmw.jpeg",
    "models": [
      {
        "model": "3er-Reihe",
        "years": ["2019", "2022"],
        "types": [
          {
            "type": "3er-Reihe G20/G21/G80",
            "engines": [
              { "hsn": "0005", "tsn": "CNA", "label": "320i 184 PS" }
            ]
          }
        ]
      }
    ]
  }
]

GET /catalog

Gibt den vollständigen Fahrzeugkatalog zurück, strukturiert nach Marke → Modell → Generation. Jede Generation enthält ein vehicles-Array (ADAC-Fahrzeugvarianten) sowie ein engines-Array mit deduplizierten Motorisierungen, gruppiert nach Trim + Leistung (kW). Jede Engine enthält alle zugehörigen HSN/TSN-Paare im pairs-Array. Ergebnis wird 24h gecacht.

Response (200) — Struktur

[
  {
    "brand": "BMW",
    "models": [
      {
        "value": "5er-Reihe",
        "label": "5er-Reihe",
        "generations": [
          {
            "value": "5er-Reihe E39",
            "label": "5er-Reihe E39",
            "years": "1996 - 2000",
            "vehicles": [
              { "value": "988286", "label": "BMW 520i", "powerInHP": "150", "powerInKW": "110" }
            ],
            "engines": [
              {
                "hsn": "0005",
                "tsn": "ABC",
                "label": "520d (136 PS / 100 kW)",
                "kw": 100,
                "ps": 136,
                "fuel": "Diesel",
                "years": "09/00 - 07/03",
                "pairs": [
                  { "hsn": "0005", "tsn": "ABC" }
                ]
              },
              {
                "hsn": "0005",
                "tsn": "572",
                "label": "540i (286 PS / 210 kW)",
                "kw": 210,
                "ps": 286,
                "fuel": "Benzin",
                "years": "1996 - 2000",
                "pairs": [
                  { "hsn": "0005", "tsn": "572" }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
]

engines Objekt

Feld	Typ	Beschreibung
`hsn`	String	Herstellerschlüsselnummer (erstes HSN/TSN-Paar der Gruppe)
`tsn`	String	Typschlüsselnummer
`label`	String	Lesbarer Name, z.B. `520d (136 PS / 100 kW)`
`kw`	Integer\|null	Leistung in kW
`ps`	Integer\|null	Leistung in PS
`fuel`	String\|null	Kraftstoffart, z.B. `Diesel`, `Benzin`
`years`	String	Bauzeitraum, z.B. `09/00 - 07/03`
`pairs`	Array	Alle HSN/TSN-Paare dieser Engine-Gruppe. Jedes Objekt: `{"hsn": "...", "tsn": "..."}`

Hinweis: engines ist alphabetisch nach label sortiert. Es kann ein leeres Array sein, wenn keine Fahrzeugzuordnung für diese Generation vorliegt. Das Shop-Frontend kann hsn/tsn direkt aus dem Engine-Objekt zum Fitment-Lookup nutzen — kein zweiter API-Call nötig.

GET /insurance?hsn=0603&tsn=COB

Gibt Versicherungsdaten (Typklassen) für ein Fahrzeug oder eine Marke/Modell-Kombination zurück. Die Daten umfassen Haftpflicht (KH), Teilkasko (TK), Vollkasko (VK) und eine 5-Jahres-Historie.

Parameter	Typ	Beschreibung
`hsn` & `tsn`	String	Spezifische Abfrage nach Fahrzeugschlüsseln (Pflichtfeld wenn brand/model fehlt).
`brand` & `model`	String	Abfrage nach Hersteller und Modell (Pflichtfeld wenn hsn/tsn fehlt).

Response (200)

{
  "hsn": "0603",
  "tsn": "COB",
  "insurance": {
    "kh": 22,
    "tk": 27,
    "vk": 26,
    "typklassen_history": {
      "Haftpflicht": { "2022": 18, "2023": 19, "2024": 19, "2025": 20, "2026": 22 },
      "Teilkasko": { "2022": 25, "2023": 25, "2024": 26, "2025": 26, "2026": 27 },
      "Vollkasko": { "2022": 24, "2023": 24, "2024": 25, "2025": 26, "2026": 26 }
    }
  }
}

Fehlercodes

Code	Bedeutung
`400`	Fehlende oder ungültige Parameter
`401`	Fehlende oder ungültige API-Credentials (Key/Secret)
`403`	Abonnement nicht aktiv oder abgelaufen
`404`	Fahrzeug nicht gefunden
`500`	Interner Serverfehler

Inhalt