Dokumentacja API

Dokumentacja

Dokumentacja EnCarAPI. Dowiedz się, jak uzyskać dostęp do danych koreańskich samochodów przez endpointy API. Przewodniki integracji i przykłady kodu.

Interaktywna dokumentacja API Specyfikacja OpenAPI

Doświadczenie w branży

Dostawca API danych motoryzacyjnych z wieloletnim doświadczeniem na rynku koreańskim.

Wsparcie 7 dni w tygodniu

Zespół wsparcia dostępny 7 dni w tygodniu w zakresie pomocy z integracją API.

Serwis 24/7

Całodobowy monitoring dla niezawodnej dostawy danych.

Powiadomienia o ogłoszeniach w czasie rzeczywistym

Natychmiastowy dostęp przez API do nowych ogłoszeń samochodów w momencie ich publikacji.

Pliki CSV do pobrania

Pobierz listy marek, modeli i badge jako CSV - zapisz je w pamięci podręcznej i pomiń zapytania facetowe na żywo.

Elastyczne formaty eksportu

Otrzymuj dane w formatach CSV, JSON, Excel i niestandardowych formatach dla łatwej integracji.

Bazowy URL

Wszystkie zapytania API kierowane są pod następujący bazowy URL:

url

https://api.encarapi.com

Na przykład, aby pobrać oferty:

http

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

Interaktywna dokumentacja API Specyfikacja OpenAPI

Uwierzytelnianie

Uwierzytelniaj swoje zapytania za pomocą klucza API. Przekaż go jako parametr zapytania lub przez nagłówek Authorization.

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

Proces integracji

Wykonaj te cztery kroki, aby zintegrować się z EnCarAPI.

Pobierz dostępne filtry

Pobierz wszystkie możliwe wartości filtrów (marki, modele, konfiguracje, kolory itp.)

GET /filters

Pobierz ogłoszenia pojazdów

Pobierz stronicowaną listę ogłoszeń z opcjonalnymi filtrami według marki, modelu, roku, ceny i innych.

GET /offers?page=1

Śledź zmiany

Pobierz identyfikator zmiany dla daty, a następnie odpytuj o dodane, zmienione i usunięte ogłoszenia.

GET /change_id → GET /changes

Pobierz szczegóły ogłoszenia

Pobierz pełne dane konkretnego ogłoszenia według jego inner_id.

GET /offer?inner_id=...

Endpointy API

Wszystkie dostępne endpointy do uzyskiwania danych koreańskich pojazdów.

Dane list rozwijanych (CSV)

Pobierz listy marek, modeli i badge jako CSV, zapisz je w pamięci podręcznej i zbuduj z nich swoje listy rozwijane - żadnych zapytań facetowych przy każdym kliknięciu i żadnego mapowania offline. Każdy plik zawiera kolumnę z liczbą, a plik badge niesie podział według typu nadwozia (Coupe / Sedan / Kabriolet).

Pobierz raz, zapisz w pamięci podręcznej - Aktualizowane codziennie

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

Wszystkie marki z liczbą ogłoszeń

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

Wszystkie kombinacje marki i modelu z liczbami

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

Wszystkie wartości marki, modelu i badge (w tym Coupe / Sedan / Kabriolet) z liczbami

Dodaj swój klucz API, aby pobrać - dołącz ?api_key=YOUR_KEY do adresu URL pliku. Pliki są chronione kluczem, bez ważnego klucza nikt ich nie pobierze.

Aktualność danych

Katalog (ceny, przebieg, nowe i sprzedane ogłoszenia) jest odświeżany mniej więcej co 5 godzin, z jednym głębszym przebiegiem dziennie. Szczegóły pojazdu (dane techniczne, zdjęcia, stan, raport o wypadkach) mają własny, wolniejszy cykl - zwykle w ciągu 3 tygodni od zmiany, szybciej jeśli katalog wskaże coś istotnego.

Zakres katalogu

GET /api/catalog obejmuje wyłącznie standardowe ogłoszenia sprzedaży (typ sprzedaży Encar „일반”). Przejęcia leasingu („리스”) i wynajem („렌트”) nie są tu mieszane - są wyceniane na podstawie raty miesięcznej, a nie ceny zakupu, co zniekształcałoby pole Price. Użyj do tego GET /api/catalog/leasing.

Jak długo przechowywać w pamięci podręcznej

Wartości filtrów, taksonomiczne pliki CSV i /api/nav: pamięć podręczna na 24 godziny
Ogłoszenia pojazdów (/api/catalog): pamięć podręczna na 4 do 6 godzin
Szczegóły pojazdu (/api/vehicle/:id): pamięć podręczna na 24 godziny

To jest model Starter: udostępniaj ogłoszenia z własnej bazy danych i odświeżaj je w tym rytmie, zamiast wykonywać zapytania na żywo przy każdym kliknięciu użytkownika. W tym planie obowiązuje dzienny limit wolumenu katalogu - jest on przeznaczony do zapytań na żywo, a nie do przechowywania pełnej lokalnej kopii.

Business / Scale

Potrzebujesz pełnej lokalnej kopii?

Plany Business i Scale zawierają GET /api/catalog/export (pełny dzienny zrzut CSV, który nie wlicza się do dziennego limitu) oraz GET /api/catalog/changes?since=... (dodane, zaktualizowane, ponownie pojawione i usunięte ogłoszenia od ostatniej synchronizacji). Zasil swoją bazę danych z eksportu jednorazowo, a następnie odpytuj zmiany, aby utrzymać ją na bieżąco - bez ponownego pobierania całego katalogu. Scale dodatkowo całkowicie znosi dzienny limit wolumenu katalogu.

Zduplikowane ogłoszenia

Koreańscy dealerzy często wystawiają ten sam fizyczny samochód dwukrotnie pod różnymi identyfikatorami ogłoszeń dla większej widoczności - ta sama cena, przebieg, rocznik i model/wersja wyposażenia. Wykrywamy takie przypadki i oznaczamy dodatkowe kopie jako IsDuplicate: true oraz DuplicateOf: <ID ogłoszenia oryginalnego> na elemencie katalogu; oryginalne ogłoszenie pozostaje nieoznaczone. Duplikaty są oznaczane, a nie usuwane, więc sam decydujesz, jak je traktować - przekaż exclude_duplicates=true do /api/catalog lub /api/catalog/leasing, aby odfiltrować je po stronie serwera.

Najczęściej zadawane pytania

Gotowy, aby zacząć?

Skontaktuj się z nami na Telegramie, aby uzyskać dane dostępowe do API i rozpocząć dostęp do danych koreańskich samochodów już dziś.

Kontakt na Telegramie