Encar API FAQ: pytania i odpowiedzi

Nie. Encar.com nie udostępnia publicznego API, portalu dla deweloperów ani samoobsługowego programu partnerskiego. Encar API to niezależna usługa dostarczająca te same dane ogłoszeń przez czysty endpoint REST.

REST API, które zwraca na żywo koreańskie ogłoszenia aut używanych z Encar.com jako JSON. Trzy endpointy, filtry marki, paliwa, rocznika, przebiegu i ceny, bez scrapingu.

Wyślij zapytanie GET do /cars ze swoimi filtrami, a dostaniesz stronicowany JSON. Uwierzytelniasz się, wysyłając klucz w nagłówku x-api-key. Darmowy klucz obejmuje 100 zapytań dziennie i jest wydawany natychmiast na tej stronie.

Każde ogłoszenie zawiera producenta, model, wersję, rocznik, przebieg, rodzaj paliwa, skrzynię, kolor, cenę, moc silnika, ścieżki zdjęć, koreański region, w którym stoi auto, oraz niemieckie i angielskie tłumaczenia modelu i wersji. Dostępnych jest ponad 190 000 aktywnych ogłoszeń.

Jest plan darmowy: 3000 zapytań miesięcznie, bez karty, bez wygaśnięcia. Pro kosztuje 49 EUR miesięcznie za 150 000 zapytań, Business 199 EUR za 750 000, a Enterprise 499 EUR miesięcznie bez limitu zapytań. Wartość miesięczna to limit dzienny rozłożony równomiernie, więc rozpędzony skrypt nie zużyje miesiąca w jedno popołudnie.

Przekaż filtry jako parametry query do /cars: manufacturer, model, fuel, transmission, colour, yearFrom i yearTo, mileageFrom i mileageTo, priceFrom i priceTo w euro oraz sort=priceAsc lub priceDesc. Na stronę wraca do 500 ogłoszeń.

Pole Price w ogłoszeniu jest w jednostkach po 10 000 KRW, więc 4339 oznacza około 29 070 EUR. Filtry priceFrom i priceTo podaje się natomiast w euro i są przeliczane za ciebie.

Pobierz pojazd przez /car?id=... — dostępność jest sprawdzana na żywo przy każdym wywołaniu szczegółów. Sprzedane lub wycofane ogłoszenie odpowiada HTTP 404 z kodem SOLD_OR_REMOVED, co jest sygnałem do usunięcia.

Tak i to jest główne zastosowanie. K-Imports w Niemczech, Inspecto na Białorusi i BBS Korea Auto Imports w Kosowie opierają na nim publiczne stany magazynowe. Pobieraj, gdy pyta odwiedzający, a nie według harmonogramu; odpowiedź możesz cache'ować u siebie na kilka minut.

Koreańskie wartości źródłowe plus blok de i en w każdym ogłoszeniu dla producenta, grupy modelowej, modelu, wersji i rodzaju paliwa. Strona i dokumentacja ukazują się w dziesięciu językach.

Tylko jeśli chcesz to utrzymywać. Scraper potrzebuje koreańskich proxy, psuje się przy każdej zmianie frontendu i i tak nie powie ci pewnie, że auto zostało sprzedane. Strona porównania przedstawia wszystkie trzy podejścia uczciwie, łącznie z tym, kiedy eksport masowy bije API.

Nie ma cache'u, który mógłby się zestarzeć: odczyt koreańskiego rynku następuje wtedy, gdy następuje twoje zapytanie. Auto wycofane godzinę temu już nie występuje w wynikach.