Autodoc API: passende Ersatzteile, OE-Nummern und Euro-Preise von autodoc.de als JSON

Bei Autodoc hängt fast jede Antwort am Fahrzeug. Eine Liste mit Bremsbelägen gibt es nicht für „VW Golf“, sondern nur für eine bestimmte Motorvariante wie den Golf 7 2.0 TDI mit 150 PS. Die API geht diesen Weg mit: `vehicle_lookup` führt vom Hersteller über Modell und Baureihe zur Motorvariante, `search` liefert dann die Teile, die Autodoc dafür führt, mit Preis in Euro, Marke, Herstellernummer und den technischen Angaben des Herstellers. Wer mit OE-Nummern arbeitet, etwa aus der Werkstatt oder dem Teilehandel, schlägt sie direkt mit `oem_lookup` nach. Dass Autodoc-Preise sich ändern, zeigt Autodoc selbst an: Jeder Preis trägt ein Gültigkeitsdatum (`price_valid_until`). Einen Preisverlauf führt die API nicht; wer einen braucht, baut ihn aus eigenen, datierten Abrufen auf. Bestellen oder als Händler ein eigenes Sortiment bei Autodoc anbinden lässt sich damit nicht, die API liest ausschließlich den öffentlichen Shop. autodoc.de erreicht man mit `"market": "de"`; fehlt der Wert, kommen Pfundpreise aus dem britischen Shop.

Funktionierendes Beispiel

Die 20 Bremsbelagsätze für den Golf 7 2.0 TDI (150 PS) mischen Vorder- und Hinterachse; welche Achse gemeint ist, steht in `specifications` unter „Einbauposition“. Dort steht auch, was `fits_selected_vehicle: true` nicht abdeckt: Der RIDEX-Satz im Beispiel ist laut Datenblatt nur „verwendbar für Fahrzeuge bis Bj. 2016 / 11“, während die Motorvariante von 2012 bis 2020 gebaut wurde. Für den ATE-Satz aus derselben Liste nannte `product_detail` 16 OE-Nummern, 6,95 € Versand mit „3-5 Arbeitstage“ und 14 Tage Rückgabe.

curl -X POST https://api.reefapi.com/autodoc/v1/search \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "content-type: application/json" \
  -d '{"category": "bremsbelag-10130", "maker": "vw", "model": "golf", "generation": "golf-vii-5g1-be1", "vehicle": "56147-2-0-tdi", "market": "de"}'

{
  "ok": true,
  "data": {
    "parts": [
      {
        "article_id": "7998967",
        "article_number": "402B0009",
        "url": "https://www.autodoc.de/ridex/7998967",
        "title": "RIDEX 402B0009 Bremsbeläge Vorderachse",
        "brand": "RIDEX",
        "category_name": "Bremsbeläge",
        "price": 20.49,
        "rrp": 36.1,
        "currency": "EUR",
        "rating": 4.5,
        "review_count": 73,
        "specifications": [
          { "name": "Einbauposition", "value": "Vorderachse" },
          { "name": "Dicke / Stärke", "value": "20,3" },
          { "name": "WVA-Nummer", "value": "23587, 23588, 23589, 24078" },
          { "name": "für Bremsscheibendurchmesser [mm]", "value": "288, 312" },
          { "name": "verwendbar für Fahrzeuge bis Bj.", "value": "2016 / 11" },
          { "name": "EAN-Nummer(n)", "value": "4059191313211" },
          ...
        ],
        "in_stock": true,
        "fits_selected_vehicle": true
      },
      ...
      {
        "article_id": "7896677",
        "article_number": "13.0460-2785.2",
        "title": "ATE 13.0460-2785.2 Bremsbeläge Vorderachse",
        "brand": "ATE",
        "price": 52.99,
        "rrp": 144.23,
        "currency": "EUR",
        "rating": 4.5,
        "review_count": 97,
        ...
      },
      ...
    ]
  },
  "meta": {
    "record_count": 20,
    "fitment": "vehicle",
    "pagination": { "page": 1, "per_page": 20, "total_results": null, "known_pages_at_least": 5, "has_more": true, "next_page": 2 },
    "charged_credits": 2,
    "cache_hit": false,
    "mode": "live"
  }
}

Grenzen und ehrliche Hinweise

• Von Autodoc stammt diese API nicht. Sie ist inoffiziell, und einen Vertrag mit Autodoc gibt es nicht.
• `market` kennt `uk` (Standard, Pfund), `de` und `es` (beide Euro). Artikel-, Fahrzeug- und Kategorie-IDs sind in allen drei Shops dieselben; Preis, Währung und Sprache der Texte unterscheiden sich.
• `search` braucht Hersteller, Modell, Baureihe und Motorvariante (oder eine Fahrzeug-URL). Auf allen Ebenen darüber hat Autodoc keine Teileliste, nur Empfehlungskacheln.
• Freitext in `part_search` versteht nur die Sprache des Shops. Auf autodoc.de liefert „Ölfilter“ 20 von 20 Ölfiltern; ein englischer Begriff wie „brake pads“ ergab dort beim Bau der Engine Führungshülsen und Verschleißkontakte statt Bremsbelägen. Teilenummern funktionieren in jedem Shop.
• `oem_lookup` liefert alles, was die OE-Nummer ersetzt, auch Sätze: Bei 5Q0 698 151 waren 12 der 20 Treffer Kombinationen aus Bremsscheiben und Belägen, nur 8 reine Belagsätze. Wer nur ein Teil will, filtert auf `category_name`.
• Eine Gesamtzahl der Treffer veröffentlicht Autodoc nicht; `total_results` ist null, `known_pages_at_least` ist nur eine Untergrenze.
• Einen Lagerbestand nennt Autodoc nicht. `units_left` ist Autodocs eigener Zähler und keine Lagermenge. Steht der Zähler auf 0, ist `in_stock` in der Trefferliste null, weil 0 dort nicht eindeutig „nicht lieferbar“ heißt; verlässlich ist die Verfügbarkeit in `product_detail`.
• Kundenbewertungen tragen oft keine Sterne: In unserem Abruf hatten alle drei zurückgegebenen Bewertungen `rating: null`. Das heißt „ohne Sternwertung“, nicht null Sterne. Mehr als rund 25 Bewertungen pro Teil zeigt die Seite selbst nicht.
• Gewicht und EAN stehen nur dann in der Antwort, wenn der Teilehersteller sie im Datenblatt angibt. Die Versandkosten sind Autodocs Pauschale (im Beispiel 6,95 €); einen möglichen Sperrgutzuschlag rechnet die API nicht hinzu.
• Credits pro Aufruf: `vehicle_lookup` und `categories` 1, `search`, `product_detail` und `part_search` 2, `oem_lookup` 3. Fehlgeschlagene Aufrufe, auch NOT_FOUND, werden nicht berechnet.
• Teile, Preise und Trefferlisten werden bei jedem Aufruf neu gelesen; zwischengespeichert wird nur die Kategorieliste (bis zu 6 Stunden). Ein Preis gilt für den Moment des Abrufs, und Autodoc schreibt selbst in `price_valid_until`, bis wann: bei unserem Abruf am 27. Oktober bis zum 28. Oktober.