Encar API FAQ: uw vragen, beantwoord

Nee. Encar.com biedt geen publieke API, ontwikkelaarsportaal of selfservice-partnerprogramma. Encar API is een onafhankelijke dienst die dezelfde advertentiedata levert via een schoon REST-endpoint.

Een REST-API die live Koreaanse occasionadvertenties van Encar.com als JSON teruggeeft. Drie endpoints, filters voor merk, brandstof, bouwjaar, kilometerstand en prijs, zonder scraping.

Stuur een GET-verzoek naar /cars met je filters en je krijgt gepagineerde JSON terug. Je authenticeert door je sleutel mee te sturen in de header x-api-key. Een gratis sleutel dekt 100 verzoeken per dag en wordt direct op deze site uitgegeven.

Elke advertentie bevat fabrikant, model, uitvoering, bouwjaar, kilometerstand, brandstofsoort, transmissie, kleur, prijs, motorvermogen, fotopaden, de Koreaanse regio waar de auto staat, en Duitse en Engelse vertalingen van model en uitvoering. Er zijn ruim 190.000 actieve advertenties beschikbaar.

Er is een gratis niveau: 3.000 verzoeken per maand, geen kaart, geen vervaldatum. Pro kost 49 EUR per maand voor 150.000 verzoeken, Business 199 EUR voor 750.000 en Enterprise 499 EUR per maand zonder verzoeklimiet. Het maandcijfer is een daglimiet dat gelijkmatig is verdeeld, zodat een op hol geslagen script de maand niet in één middag opmaakt.

Geef de filters als queryparameters mee aan /cars: manufacturer, model, fuel, transmission, colour, yearFrom en yearTo, mileageFrom en mileageTo, priceFrom en priceTo in euro, en sort=priceAsc of priceDesc. Er komen tot 500 advertenties per pagina terug.

Het veld Price van een advertentie staat in eenheden van 10.000 KRW, dus 4339 betekent ongeveer 29.070 EUR. De filters priceFrom en priceTo geef je daarentegen in euro op en worden voor je omgerekend.

Vraag het voertuig op met /car?id=... — de beschikbaarheid wordt bij elke detailcall live gecontroleerd. Een verkochte of ingetrokken advertentie antwoordt HTTP 404 met de code SOLD_OR_REMOVED, jouw signaal om hem te verwijderen.

Ja, en dat is het belangrijkste gebruik. K-Imports in Duitsland, Inspecto in Belarus en BBS Korea Auto Imports in Kosovo draaien er allemaal hun publieke voorraad op. Haal data op wanneer een bezoeker erom vraagt in plaats van volgens een schema, en je mag een antwoord een paar minuten op je eigen server cachen.

Koreaanse bronwaarden plus een de- en en-blok op elke advertentie voor fabrikant, modelgroep, model, uitvoering en brandstofsoort. De site en de documentatie verschijnen in tien talen.

Alleen als je het wilt onderhouden. Een scraper heeft Koreaanse proxy's nodig, breekt bij elke frontendwijziging en kan je nog steeds niet betrouwbaar vertellen dat een auto verkocht is. De vergelijkingspagina zet alle drie de benaderingen eerlijk uiteen, inclusief wanneer een bulkexport een API verslaat.

Er is geen cache die kan verouderen: het lezen van de Koreaanse markt gebeurt op hetzelfde moment als je verzoek. Een auto die een uur geleden is ingetrokken staat al niet meer in je zoekresultaten.