API-referentie

Documentatie

EnCarAPI-documentatie. Leer hoe u toegang krijgt tot Koreaanse autogegevens via directe API-eindpunten. Integratiegidsen en codevoorbeelden.

Interactieve API-referentie OpenAPI-specificatie

Ervaring in de Sector

API-aanbieder voor autogegevens met jarenlange ervaring op de Koreaanse markt.

7-daagse Ondersteuning

Ondersteuningsteam 7 dagen per week beschikbaar voor hulp bij API-integratie.

24/7 Service

Bewaking rond de klok voor betrouwbare gegevenslevering.

Realtime Aanbiedingsmeldingen

Krijg directe API-toegang tot nieuwe autoaanbiedingen zodra ze worden geplaatst.

CSV-downloads

Download merk-, model- en versielijsten als CSV - cache ze en sla live facet-aanroepen over.

Flexibele Exportformaten

Ontvang gegevens in CSV, JSON, Excel en aangepaste formaten voor eenvoudige integratie.

Basis-URL

Alle API-verzoeken worden gedaan naar de volgende basis-URL:

url

https://api.encarapi.com

Bijvoorbeeld, om aanbiedingen op te halen:

http

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

Interactieve API-referentie OpenAPI-specificatie

Authenticatie

Authenticeer uw verzoeken met een API-sleutel. Geef deze door als queryparameter of via de Authorization-header.

bash

# 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

Integratiewerkstroom

Volg deze vier stappen om te integreren met EnCarAPI.

Beschikbare Filters Ophalen

Haal alle mogelijke filterwaarden op (merken, modellen, configuraties, kleuren, enz.)

GET /filters

Voertuigaanbiedingen Ophalen

Haal gepagineerde aanbiedingen op met optionele filters voor merk, model, jaar, prijs en meer.

GET /offers?page=1

Wijzigingen Bijhouden

Verkrijg een wijzigings-ID voor een datum en poll vervolgens voor toegevoegde, gewijzigde en verwijderde aanbiedingen.

GET /change_id → GET /changes

Aanbiedingsdetails Ophalen

Haal volledige details op voor een specifieke aanbieding via het inner_id.

GET /offer?inner_id=...

API-eindpunten

Alle beschikbare eindpunten voor toegang tot Koreaanse voertuiggegevens.

Dropdown-gegevens (CSV)

Download de merk-, model- en versielijsten als CSV, cache ze en bouw je dropdowns daaruit op - geen facet-aanroepen per klik en geen offline mapping. Elk bestand bevat een aantalkolom, en het versiebestand bevat de opsplitsing per carrosserie (Coupé / Sedan / Cabrio).

Eén keer downloaden, cachen - Dagelijks bijgewerkt

https://api.encarapi.com/api/taxonomy/makes.csv?api_key=YOUR_KEY

Alle merken met aantal advertenties

https://api.encarapi.com/api/taxonomy/models.csv?api_key=YOUR_KEY

Alle merk- en modelcombinaties met aantallen

https://api.encarapi.com/api/taxonomy/badges.csv?api_key=YOUR_KEY

Alle merk-, model- en versiewaarden (incl. Coupé / Sedan / Cabrio) met aantallen

Voeg je API-sleutel toe om te downloaden - hang ?api_key=YOUR_KEY aan de bestands-URL. De bestanden zijn sleutelbeveiligd, zonder geldige sleutel kan niemand ze downloaden.

Actualiteit van de gegevens

De catalogus (prijzen, kilometerstand, nieuwe en verkochte advertenties) wordt ongeveer elke 5 uur bijgewerkt, met één keer per dag een diepere doorloop. Voertuigdetails (specificaties, foto's, staat, schaderapport) volgen hun eigen, langzamere cyclus - meestal binnen 3 weken na een wijziging, sneller als de catalogus iets relevants signaleert.

Omvang van de catalogus

GET /api/catalog omvat uitsluitend standaard verkoopadvertenties (Encars verkooptype „일반”). Leaseoverdracht („리스”) en verhuur („렌트”) worden niet meegenomen - deze worden geprijsd op basis van een maandelijkse termijn in plaats van een aankoopprijs, wat het veld Price zou vertekenen. Gebruik daarvoor GET /api/catalog/leasing.

Hoe lang cachen

Filterwaarden, taxonomie-CSV's en /api/nav: cache gedurende 24 uur
Voertuigadvertenties (/api/catalog): cache gedurende 4 tot 6 uur
Voertuigdetails (/api/vehicle/:id): cache gedurende 24 uur

Dit is het Starter-model: houd de advertenties in je eigen database bij en ververs ze op dit ritme in plaats van bij elke klik van de gebruiker live aan te roepen. Op dit plan geldt een dagelijks limiet op catalogusvolume - het is bedoeld voor live-aanvragen, niet voor het bijhouden van een volledige lokale kopie.

Business / Scale

Toch een volledige lokale kopie nodig?

Business en Scale plannen bevatten GET /api/catalog/export (een dagelijkse volledige CSV-snapshot die niet meetelt voor het dagelijkse limiet) en GET /api/catalog/changes?since=... (toegevoegde, bijgewerkte, opnieuw verschenen en verwijderde advertenties sinds je laatste synchronisatie). Vul je database eenmalig met de export, en vraag daarna alleen nog wijzigingen op om hem actueel te houden - geen herhaald ophalen van de volledige catalogus meer. Scale heft het dagelijkse limiet op catalogusvolume ook volledig op.

Dubbele advertenties

Koreaanse dealers plaatsen dezelfde fysieke auto vaak twee keer onder verschillende advertentie-ID's voor extra zichtbaarheid - zelfde prijs, kilometerstand, bouwjaar en model/uitvoering. Wij herkennen dit en markeren de extra kopieën met IsDuplicate: true en DuplicateOf: <advertentie-ID van het origineel> op het catalogusitem; de originele advertentie blijft ongemarkeerd. Duplicaten worden gemarkeerd, niet verwijderd, zodat u zelf bepaalt hoe u ermee omgaat - geef exclude_duplicates=true mee aan /api/catalog of /api/catalog/leasing om ze serverzijdig uit te filteren.

Veelgestelde Vragen

Klaar om te Beginnen?

Neem contact met ons op via Telegram om uw API-inloggegevens te ontvangen en begin vandaag nog met toegang tot Koreaanse autogegevens.

Contact op Telegram