Dokumentation

Basis-URL

Alle API-Anfragen werden an die folgende Basis-URL gesendet:

https://api.encarapi.com

Zum Beispiel, um Angebote abzurufen:

GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true

Authentifizierung

Authentifizieren Sie Ihre Anfragen mit einem API-Schlüssel. Übergeben Sie ihn als Query-Parameter oder über den Authorization-Header.

# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"

# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY

5-Tage-Trial

5 Tage die API mit allen drei Marktplätzen (Encar, KB Chachacha, K Car) testen, inklusive Änderungs-Feed (letzte 7 Tage), Sammelabruf (1.000 IDs pro Tag) und Archiv-Vorschau (100 entfernte Inserate pro Tag). 100.000 Katalogzeilen und 2.000 Detailabrufe insgesamt (max. 1.000 Abrufe pro Tag). Die Referenz-Downloads (CSV) gehören zu den bezahlten Plänen. Den kompletten Katalog-Export gibt es ab Business. Nach dem Trial läuft das Abo automatisch im Starter-Plan für 149 €/Monat weiter - jederzeit vor Tag 5 kündbar.

Russische Werte (lang=ru)

Jeder Endpunkt, der lang=en annimmt, nimmt auch lang=ru an: Die Anzeigewerte kommen auf Russisch, alles andere bleibt gleich (IDs, Codes, Preise, Zahlen, Feldnamen). Ein Wert ohne russische Bezeichnung fällt auf Englisch zurück. Die russischen Bezeichnungen können sich mit der Zeit verbessern, verknüpfen Sie Ihre Daten daher über IDs und Codes, nicht über die Bezeichnungen.

• Übersetzt: Kraftstoff, Getriebe, Antrieb, Außen- und Innenfarbe, Fahrzeugklasse, Verkaufsart, Regions- und Städtenamen, Ausstattungsnamen und die allgemeinen Wörter in Ausstattungslinien (Diesel -> дизель, 7-Seater -> 7 мест). Modellgenerationen: Carnival 4 Gen -> Carnival 4 поколение. Marken-, Modell- und Ausstattungsnamen bleiben lateinisch, wie auf russischen Automarktplätzen.
• Filter nehmen auch die russischen Werte an: fuel=дизель, color=белый, region=Сеул, city=Сувон, drivetrain=полный, sell_type=лизинг. Die englischen Werte funktionieren weiter.
• /api/enums?lang=ru ergänzt jeden Wert um nameRu und listet die Werte für drivetrain und sell_type. /api/nav?lang=ru liefert einen russischen DisplayValue; Value bleibt der englische Code zum Filtern. Die Referenz-CSVs bekommen mit lang=ru den russischen Namen als zusätzliche Spalte nach der letzten.
• /api/vehicle/{id}?lang=ru und der Bulk-Endpunkt liefern die Encar-spec-Werte, die category-Namen und die optionsDecoded-Namen auf Russisch, KB-Chachacha-Einträge wie im Katalog.
• /api/catalog/export?lang=ru ist dieselbe Datei mit den Bezeichnungsspalten auf Russisch; Spaltenreihenfolge und alle anderen Spalten bleiben unverändert.
• Nicht übersetzt: Prüfberichte, Versicherungsakten, Encar-Diagnosen, Encar-Fahrzeugverläufe, K-Car-Detaildaten, Encar-Optionspakete (Freitext aus dem Inserat) sowie die Endpunkte für Lkw und Bagger (sie antworten bei lang=ru auf Englisch).

# Russian values, filtered with Russian values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?fuel=дизель&city=Сувон&lang=ru&count=true"

# Filter values with their Russian labels (nameRu)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/enums?lang=ru"

Deutsche Werte (lang=de)

lang=de funktioniert wie lang=ru: Die Anzeigewerte kommen auf Deutsch, alles andere bleibt gleich (IDs, Codes, Preise, Zahlen, Feldnamen). Ein Wert ohne deutsche Bezeichnung fällt auf Englisch zurück.

• Übersetzt: Kraftstoff, Getriebe, Antrieb, Farben, Fahrzeugklasse, Verkaufsart, Ausstattungsnamen sowie Modell- und Ausstattungslinien aus unseren deutschen Tabellen (C-Class -> C-Klasse, 5-Series -> 5er, Carnival 4 Gen -> Carnival 4. Generation, 7-Seater -> 7-Sitzer, Sedan -> Limousine). Regionsnamen sind die englischen, Städtenamen bleiben englisch.
• Filter nehmen auch die deutschen Werte an: fuel=Benzin, color=Weiß, transmission=Automatik, drivetrain=Allrad, sell_type=Leasingübernahme, model_group=C-Klasse. Deutsche Modellnamen können Facelifts zusammenfassen: Carnival 4. Generation umfasst Carnival 4 Gen und The New Carnival 4 Gen.
• Listen, Fahrzeug-Detail, Bulk und Export funktionieren wie bei lang=ru: nameDe in /api/enums und /api/taxonomy/option-packages, ein deutscher DisplayValue in /api/nav, *_de-Spalten in den Referenz-CSVs, catalog_export_de.csv für den Export. Nicht übersetzt: dasselbe wie bei lang=ru.

# German values, filtered with German values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=Mercedes-Benz&model_group=C-Klasse&fuel=Benzin&lang=de&count=true"

Drei Marktplätze, eine API

Die API liefert Live-Inserate der drei großen Gebrauchtwagen-Marktplätze Koreas. Jeder Endpunkt gibt standardmäßig Encar zurück, bestehende Integrationen funktionieren also unverändert weiter. Die beiden anderen werden über den Parameter source hinzugeschaltet.

Quellen auswählen

source wird von /api/catalog, /api/nav, /api/enums, /api/model-search, /api/catalog/export, /api/catalog/changes und den Taxonomie-CSVs akzeptiert.

# All three marketplaces, English values
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=all&manufacturer=bmw&fuel=diesel&lang=en&count=true"

# K Car only
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?source=kcar&manufacturer=hyundai&lang=en"

# One KB Chachacha vehicle
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/vehicle/kbc:12345678?lang=en"

Ist source gesetzt, enthält jeder Eintrag ein Feld Source. Encar-IDs bleiben reine Zahlen. IDs von KB Chachacha und K Car tragen ein Präfix (kbc:..., kcar:...) - übergeben Sie sie unverändert an /api/vehicle/{id}. Mit lang=en werden Modell- und Ausstattungsnamen aller drei Marktplätze auf Englisch zurückgegeben.

Händler inserieren dasselbe Fahrzeug häufig auf Encar und KB Chachacha. Ein KB-Chachacha-Inserat wird einem aktiven Encar-Inserat über das koreanische Kennzeichen zugeordnet oder, wenn KB Chachacha kein Kennzeichen veröffentlicht, über Erstzulassungsmonat, Kilometerstand und Preis; die Zuordnung wird mehrmals täglich nach jedem Encar- und KB-Chachacha-Katalogdurchlauf neu berechnet. Zugeordnete KB-Chachacha-Inserate liefern /api/catalog, /api/catalog/export und die anderen Katalog-Endpunkte nicht aus, mit oder ohne source (auch nicht mit source=kbc allein) - so erscheint dasselbe Fahrzeug nie doppelt; ist Encar enthalten, kommt es als Encar-Inserat.

In /api/catalog/changes?source=kbc und /api/vehicle/kbc:{id} tragen diese Inserate IsDuplicate: true und DuplicateOf (die ID des Encar-Inserats als numerischer String); wie bei Encar-Einträgen sind beide Felder nur vorhanden, wenn sie zutreffen. Wird die Markierung gesetzt oder aufgehoben, protokolliert der Änderungs-Feed ein updated-Ereignis, dessen changedFields duplicate enthält. Damit deine lokale Kopie mit /api/catalog übereinstimmt, entferne KB-Chachacha-Einträge, die mit IsDuplicate: true eintreffen, und nimm sie wieder auf, sobald ein Update ohne dieses Feld eintrifft.

Der Änderungs-Feed nimmt pro Aufruf eine Quelle entgegen (encar, kbc oder kcar) und führt für jede einen eigenen Cursor.

Abdeckung pro Marktplatz

Nicht jeder Marktplatz veröffentlicht jedes Feld.

• KB Chachacha veröffentlicht die Sitzanzahl für einen Teil seiner Inserate.
• KB-Chachacha-Detail = der Katalogeintrag plus der öffentliche Historienblock (Unfallkennzeichen, Totalschaden, Überschwemmung, gewerbliche Nutzung, Pfandrechte, Rahmen- und Karosserieteil-Diagnose). Jeder KB-Chachacha-Eintrag enthält außerdem InsuranceClaims: die Anzahl der Versicherungsschäden, die auf der Inseratsseite angezeigt wird. Das Detail enthält außerdem InspectionReportUrl und InspectionReportType: den Prüfbericht, den KB Chachacha für das Auto zeigt (link = Bericht auf der Website des Prüfbetriebs, scan = nur eingescannte Bilder auf der Inseratsseite, null = noch unbekannt). Ist InspectionAvailable true, liefert GET /api/inspection/kbc:{id} diesen Bericht als strukturierte Daten im selben Format wie einen Encar-Prüfbericht (master, outers, inners, images), dazu einen source-Block - bei etwa zwei von fünf KB-Chachacha-Inseraten mit verlinktem Bericht.
• K Car hat keine separaten Berichtsdokumente; Unfallanzahl, Versicherungszahlungen und Halterwechsel sind Teil des Fahrzeugdetails.

Das Filtern nach einem Feld, das ein Marktplatz nicht bereitstellt, schließt die Fahrzeuge dieses Marktplatzes aus den Ergebnissen aus. Beispiel: frame_clean=true mit source=all liefert nur Inserate von Encar und K Car.

API-Endpunkte

Alle verfügbaren Endpunkte für den Zugriff auf koreanische Fahrzeugdaten.

Dropdown-Daten (CSV)

Lade die Marken-, Modell- und Badge-Listen als CSV herunter, cache sie und baue deine Dropdowns daraus - keine Facetten-Calls pro Klick und kein Offline-Mapping. Jede Datei enthält eine Count-Spalte, und die Badge-Datei enthält die Karosserie-Trennung (Coupé / Limousine / Cabrio).

Häufig gestellte Fragen