DokumentacjaDokumentacja API
Dokumentacja API scrapera motoryzacyjnego. Dostęp do danych samochodowych przez endpointy API. Przewodniki integracji i przykłady kodu.
Czyste, ustrukturyzowane dane motoryzacyjne przez API. Bez skomplikowanej konfiguracji, zarządzania infrastrukturą czy utrzymania technicznego.
Dlaczego My
Doświadczenie branżowe
Dostawca API danych motoryzacyjnych z ponad 8-letnim doświadczeniem od 2017 roku.
Wsparcie 7 Dni
Zespół wsparcia dostępny 7 dni w tygodniu do pomocy w integracji API.
Usługa 24/7
Ciągłe monitorowanie przez całą dobę dla niezawodnego dostarczania danych.
Kluczowe możliwości API
Powiadomienia o ogłoszeniach w czasie rzeczywistym
Natychmiastowy dostęp przez API do nowych ogłoszeń samochodowych po publikacji.
Codzienne eksporty danych
Codzienne eksporty aktywnych i wycofanych ogłoszeń do analizy rynku i śledzenia sprzedaży.
Elastyczne formaty eksportu
Dane w formatach CSV, JSON, Excel i niestandardowych dla łatwej integracji.
Często zadawane pytania
Jak działa API motoryzacyjne?
API motoryzacyjne zapewnia dostęp w czasie rzeczywistym do danych z wiodących portali samochodowych. Dostarcza ustrukturyzowane dane przez REST API do natychmiastowej analizy.
Jakie zbiory danych zapewnia API motoryzacyjne?
Uzyskaj kompletne dane samochodowe, w tym specyfikacje, ceny, informacje o sprzedawcy, lokalizację i przebieg. Dostęp do milionów ogłoszeń z głównych platform przez wywołania API.
Czy istnieją limity użytkowania dla API motoryzacyjnego?
Brak limitów użytkowania, z ograniczeniem liczby zapytań dla stabilnej wydajności. Uzyskaj wszystkie aktywne ogłoszenia w regionach przez API czasu rzeczywistego lub codzienne eksporty. Brak ograniczeń dla partnerów korporacyjnych.
Jak mogę śledzić nowe ogłoszenia samochodowe za pomocą API czasu rzeczywistego?
Monitoruj ogłoszenia za pomocą parametru 'change_id'. Zacznij od change_id=0, następnie użyj ID ostatniej zmiany + 1. Przechwytuje to nowe ogłoszenia, zmiany cen i wycofania na platformach.
Jakie formaty danych obsługujecie?
Otrzymuj dane w formatach CSV, JSON, Excel i bazach danych. Wszystkie formaty zawierają kompletne dane ze wszystkich platform.
Czy możecie zapewnić niestandardowy dostęp API do konkretnego portalu?
Tak, budujemy niestandardowe rozwiązania API dla dowolnego portalu samochodowego. Uzyskaj dostosowany dostęp do danych dla swoich specyficznych potrzeb. Skontaktuj się z nami w sprawie wymagań.
Czy moje wykorzystanie danych i współpraca są poufne?
Tak. Pracujemy na podstawie ścisłych umów o poufności ze wszystkimi klientami. Twoje wykorzystanie naszych usług danych samochodowych pozostaje całkowicie prywatne i bezpieczne.
Czy muszę zarządzać jakąkolwiek infrastrukturą lub serwerami?
Nie, usługa jest w pełni zarządzana. Zajmujemy się całą infrastrukturą, serwerami i zbieraniem danych. Uzyskujesz gotowe do użycia dane bez konieczności konfiguracji technicznej.
Bazowy URL
https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}Autoryzacja: api_key parameter
Schemat integracji
/filterspobierz dostępne wartości filtrów/offerspobierz ogłoszenia (z filtrami lub bez) - użyj do początkowego ładowania danychDla aktualizacji (utrzymanie aktualności danych po początkowym ładowaniu):
/change_id?date=...pobierz początkowe ID dla strumienia zmian/changes?change_id=...pobierz wszystkie zmiany w bazie danych od podanego ID/offerpobierz szczegóły konkretnego ogłoszenia według inner_idZalecane podejście do integracji:
1. Najpierw użyj /offers do początkowego pobrania danych (przejdź przez wszystkie strony)
2. Następnie użyj /changes do okresowego pobierania wszystkich zmian (dodane/zmodyfikowane/usunięte), aby zsynchronizować lokalną bazę danych ze źródłem
3. Do integracji danych na stronie internetowej możesz użyć /offers z filtrami i paginacją (marka, model, cena, rok itp.)
GET/filters
Zwraca wszystkie możliwe wartości do filtrowania
https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEYOdpowiedź:
{
"mark": {
"Hyundai": {
"model": {
"Sonata": {
"configuration": {
"DN8": { "complectation": ["Smart", "Modern", "Premium"] }
}
}
}
},
"Kia": {
"model": {
"K5": {
"configuration": {
"DL3": { "complectation": ["LX", "EX", "SX"] }
}
}
}
}
},
"transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
"color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
"body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
"engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}GET/offers
Lista ogłoszeń z paginacją i filtrami
Parametry:
page(wymagane) - numer stronymark, model, configuration, complectation- filters (bez rozróżniania wielkości liter)transmission_type, color, body_type, engine_type- filters (bez rozróżniania wielkości liter)year_from, year_to- filtr zakresu latkm_age_from, km_age_to- filtr zakresu przebieguprice_from, price_to- filtr zakresu cen (w jednostkach 10 000 KRW)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=blackOdpowiedź:
{
"result": [
{
"id": 3219435,
"inner_id": "40427050",
"change_type": "added",
"created_at": "2025-09-08T12:02:03.000Z",
"data": {
"id": 1454012,
"inner_id": "40427050",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
"mark": "Hyundai",
"model": "Palisade",
"generation": "Diesel 2.2 4WD",
"configuration": "Diesel 2.2 4WD",
"complectation": "Prestige",
"year": 2021,
"color": "Black",
"price": 3190,
"price_won": "31900000",
"km_age": 92842,
"engine_type": "Diesel",
"transmission_type": "Automatic",
"body_type": "SUV",
"address": "Busan Gijang-gun",
"seller_type": "DEALER",
"is_dealer": true,
"images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
"extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
}
}
],
"meta": { "page": 1, "next_page": 2, "limit": 20 }
}Pola danych:
- id - wewnętrzne ID bazy danych
- inner_id - ID ogłoszenia na platformie
- url - link do ogłoszenia
- mark - marka samochodu
- model - model samochodu
- generation - generacja
- configuration - konfiguracja
- complectation - wersja wyposażenia
- year - rok produkcji
- color - kolor
- price - cena (w jednostkach 10 000 KRW)
- price_won - pełna cena w KRW
- km_age - przebieg w km
- engine_type - typ silnika
- transmission_type - typ skrzyni biegów
- body_type - typ nadwozia
- address - adres
- seller_type - typ sprzedawcy
- is_dealer - flaga dealera (true/false)
- section - sekcja
- seller - sprzedawca
- salon_id - ID dealera
- description - opis
- displacement - pojemność silnika (cc)
- offer_created - data utworzenia ogłoszenia
- images - tablica URL-i zdjęć
- extra - dodatkowe dane (JSON)
- options - lista opcji
GET/change_id
Pobierz pierwsze ID zmiany według daty (do użycia w /changes)
Parametry:
date(wymagane) - data w formacie yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15Odpowiedź:
{ "change_id": 1547283 }Użyj zwróconej wartości jako parametru change_id w /changes
GET/changes
Strumień zmian (dodano/zmieniono/usunięto)
Parametry:
change_id(wymagane) - od którego ID zmiany
https://{access_name}.auto-api.com/api/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1Odpowiedź:
{
"result": [
{
"id": 456,
"inner_id": "40427050",
"change_type": "added", // added - new listing
"created_at": "2025-01-15T10:30:00Z",
"data": { ... } // full listing data
},
{
"id": 457,
"inner_id": "40427051",
"change_type": "changed", // changed - price update
"created_at": "2025-01-15T10:31:00Z",
"data": { "new_price": 3490 }
},
{
"id": 458,
"inner_id": "40427052",
"change_type": "removed", // removed - listing deleted
"created_at": "2025-01-15T10:32:00Z"
}
],
"meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}GET/offer
Pojedyncze ogłoszenie według inner_id
Parametry:
inner_id(wymagane)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050Odpowiedź: obiekt data (taki sam jak w /offers, ale bez wrappera result)
Pobierz pełne dane ogłoszenia podając oryginalny URL z dowolnej obsługiwanej platformy. Idealne do szybkich wyszukiwań i pobierania pojedynczych ogłoszeń.
Bazowy URL
https://{access_name}.auto-api.com/api/v1/offer/infoAutoryzacja przez nagłówek x-api-key
POST/api/v1/offer/info
Wyślij żądanie POST z URL ogłoszenia, aby uzyskać pełne dane
Parametry:
url(wymagane) - link do ogłoszenia na dowolnej obsługiwanej platformie
Przykład żądania:
curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'Odpowiedź:
{
"inner_id": "39225419",
"url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
"mark": "BMW",
"model": "5-Series",
"generation": "528i",
"year": 2010,
"year_month": "2010-08",
"color": "Silver",
"price": 880,
"price_won": 8800000,
"km_age": 132437,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "Sedan",
"displacement": "2996",
"power": "230",
"vin": "WBAFR1105AC258998",
"address": "Gwangju Seo-gu",
"seller_type": "DEALER",
"is_dealer": true,
"offer_created": "2025-11-17",
"images": [
"https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
"https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
]
}Pola danych:
- inner_id - ID ogłoszenia na platformie
- url - link do ogłoszenia
- mark - marka samochodu
- model - model samochodu
- generation - generacja
- year - rok produkcji
- year_month - rok i miesiąc produkcji
- color - kolor
- price - cena w jednostkach 10000 KRW
- km_age - przebieg w km
- engine_type - typ silnika
- transmission_type - typ skrzyni biegów
- body_type - typ nadwozia
- displacement - pojemność silnika (cc)
- power - moc w KM
- vin - kod VIN
- address - adres
- seller_type - typ sprzedawcy
- is_dealer - flaga dealera (true/false)
- offer_created - data utworzenia ogłoszenia
- images - tablica URL-i zdjęć
Zasady przechowywania danych
Pliki przechowywane przez minimum 3+ dni
Harmonogram dostępności API
Świeże pliki dzienne dostępne do pobrania
Format danych CSV
Pliki CSV używają znaku pionowej kreski (|) jako separatora kolumn
Struktura URL:
Parametry Żądania:
access_name- Twój przypisany identyfikator subdomenydate- data docelowa w formacie RRRR-MM-DD (np. 2025-09-06)file_name- nazwa pliku eksportu z rozszerzeniem
Dostępne formaty:
- CSV - all_active.csv, new_daily.csv, removed_daily.csv
- JSON - all_active.json, new_daily.json, removed_daily.json
- Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx
Przykład żądania cURL API
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvPrzykład pobrania przez Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'