Dokumentation
EnCarAPI-Dokumentation. Erfahren Sie, wie Sie ĂŒber direkte API-Endpunkte auf koreanische Fahrzeugdaten zugreifen. IntegrationsleitfĂ€den und Code-Beispiele.
Branchenerfahrung
Anbieter von Automobil-Daten-APIs mit jahrelanger Erfahrung auf dem koreanischen Markt.
7-Tage-Support
Support-Team 7 Tage die Woche fĂŒr Hilfe bei der API-Integration verfĂŒgbar.
24/7-Service
Rund-um-die-Uhr-Ăberwachung fĂŒr zuverlĂ€ssige Datenlieferung.
Echtzeit-Angebotsmeldungen
Erhalten Sie sofortigen API-Zugriff auf neue Fahrzeugangebote, sobald sie veröffentlicht werden.
CSV-Downloads
Marken-, Modell- und Badge-Listen als CSV herunterladen - cachen und Live-Facetten-Calls sparen.
Flexible Exportformate
Erhalten Sie Daten in CSV, JSON, Excel und benutzerdefinierten Formaten fĂŒr einfache Integration.
Basis-URL
Alle API-Anfragen werden an die folgende Basis-URL gesendet:
https://api.encarapi.comZum Beispiel, um Angebote abzurufen:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=trueAuthentifizierung
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_KEYIntegrations-Arbeitsablauf
Befolgen Sie diese vier Schritte zur Integration mit der EnCarAPI.
VerfĂŒgbare Filter abrufen
Alle möglichen Filterwerte abrufen (Marken, Modelle, Konfigurationen, Farben usw.)
GET /filtersFahrzeugangebote abrufen
Paginierte Angebote mit optionalen Filtern fĂŒr Marke, Modell, Baujahr, Preis und mehr abrufen.
GET /offers?page=1Ănderungen verfolgen
Eine Ănderungs-ID fĂŒr ein Datum abrufen, dann nach hinzugefĂŒgten, geĂ€nderten und entfernten Angeboten abfragen.
GET /change_id â GET /changesAngebotsdetails abrufen
VollstĂ€ndige Details fĂŒr ein bestimmtes Angebot anhand seiner inner_id abrufen.
GET /offer?inner_id=...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).
Einmal herunterladen, cachen - TĂ€glich aktualisiert
Alle Marken mit Inserats-Anzahl
Alle Marken-/Modell-Kombinationen mit Anzahl
Alle Marken-, Modell- und Badge-Werte (inkl. Coupé / Limousine / Cabrio) mit Anzahl
Zum Herunterladen den API-Key anhĂ€ngen - ?api_key=YOUR_KEY an die Datei-URL hĂ€ngen. Die Dateien sind key-geschĂŒtzt, ohne gĂŒltigen Key kann sie niemand herunterladen.
DatenaktualitÀt
Der Katalog (Preise, Kilometerstand, neue und verkaufte Inserate) wird etwa alle 5 Stunden aktualisiert, dazu einmal tĂ€glich ein tieferer Durchlauf. Fahrzeug-Details (Ausstattung, Fotos, Zustand, Unfallbericht) folgen einem eigenen, langsameren Zyklus - meist innerhalb von 3 Wochen nach einer Ănderung, schneller wenn der Katalog einen relevanten Hinweis liefert.
Umfang des Katalogs
GET /api/catalog umfasst nur Standard-Verkaufsinserate (Encars Verkaufsart âìŒë°â). Leasing-Ăbernahmen (â늏ì€â) und Mietfahrzeuge (âë ížâ) werden nicht mit reingemischt - sie werden ĂŒber eine monatliche Rate statt einem Kaufpreis bepreist, was das Preisfeld verfĂ€lschen wĂŒrde. Nutze dafĂŒr GET /api/catalog/leasing.
Wie lange cachen
- Filterwerte, Taxonomie-CSVs und /api/nav: 24 Stunden cachen
- Fahrzeug-Inserate (/api/catalog): 4 bis 6 Stunden cachen
- Fahrzeug-Details (/api/vehicle/:id): 24 Stunden cachen
Das ist das Starter-Modell: Halte die Inserate in deiner eigenen Datenbank und aktualisiere in diesem Takt, statt live bei jedem Klick abzufragen. Auf diesem Plan gilt ein tĂ€gliches Katalog-Volumenlimit - er ist fĂŒr Live-Abfragen gedacht, nicht fĂŒr eine vollstĂ€ndige lokale Kopie.
Brauchst du stattdessen eine vollstÀndige lokale Kopie?
Business- und Scale-Plan enthalten GET /api/catalog/export (ein tĂ€glicher CSV-Voll-Snapshot, zĂ€hlt nicht gegen das Tageslimit) sowie GET /api/catalog/changes?since=... (neue, aktualisierte, wiederaufgetauchte und entfernte Inserate seit deinem letzten Sync). BefĂŒlle deine Datenbank einmalig aus dem Export, danach fragst du nur noch Ănderungen ab - kein erneutes Ziehen des kompletten Katalogs mehr. Scale hebt das tĂ€gliche Katalog-Volumenlimit zusĂ€tzlich komplett auf.
Doppelte Inserate
Koreanische HĂ€ndler inserieren dasselbe Auto hĂ€ufig zweimal unter verschiedenen Listing-IDs fĂŒr mehr Sichtbarkeit - gleicher Preis, gleiche Laufleistung, gleiches Baujahr und Modell/Ausstattung. Wir erkennen das und markieren die zusĂ€tzlichen Kopien mit IsDuplicate: true und DuplicateOf: <Listing-ID des Originals> am Katalog-Eintrag; das Original bleibt unmarkiert. Duplikate werden markiert, nicht entfernt, du entscheidest selbst - mit exclude_duplicates=true bei /api/catalog oder /api/catalog/leasing werden sie serverseitig herausgefiltert.
HĂ€ufig gestellte Fragen
Bereit loszulegen?
Kontaktieren Sie uns auf Telegram, um Ihre API-Zugangsdaten zu erhalten und noch heute auf koreanische Fahrzeugdaten zuzugreifen.