API VIN w komisie: dane pojazdu we własnym programie
Dodaj autobaza.pl do źródeł Google
Redakcja
Autobaza.pl to portal motoryzacyjny specjalizujący się w raportach VIN, historii pojazdów i poradach dla kierowców. Tworzymy rzetelne treści, które pomagają podejmować świadome decyzje przy zakupie i użytkowaniu samochodów. Nasza redakcja łączy pasję do motoryzacji z wieloletnim doświadczeniem, przedstawiając złożone zagadnienia w prosty i praktyczny sposób. Publikujemy analizy, poradniki oraz aktualności dotyczące bezpieczeństwa, ekologii i nowych trendów w branży. Regularnie współpracujemy z partnerami, przygotowując także treści o charakterze promocyjnym. Naszym celem jest wspieranie kierowców w lepszym zrozumieniu rynku motoryzacyjnego i codziennej eksploatacji pojazdów.

VIN, dane techniczne, wycena i historia mogą trafiać bezpośrednio do programu Twojego komisu. Zobacz, które funkcje API odpowiadają poszczególnym etapom pracy, ile kosztują i jakie mają ograniczenia.
W skrócie
- Pobierzesz VIN po numerze rejestracyjnym, ale nadal musisz porównać go z autem i dokumentami.
- Dane zapisane w VIN-ie i specyfikacja katalogowa mają różny zakres.
- Pełna historia nie obejmuje szkód ani sprawdzenia baz aut kradzionych.
- Licencja służy do pobierania raportów w przeglądarce, a API do zasilania Twojego programu.
Każde auto w Twoim komisie przechodzi podobną drogę: przyjęcie, opis, wycena i rozmowa z kupującym. Przy większej rotacji wracają te same problemy: literówka w VIN-ie w umowie, wyposażenie w ogłoszeniu inne niż w dokumentach i cena ustalana „na oko”.
Jeśli masz własny program, arkusz połączony z bazą albo system do ogłoszeń, możesz zasilać go danymi przez API. W tym poradniku zobaczysz, które funkcje pasują do kolejnych etapów pracy i gdzie nadal potrzebna jest Twoja ocena.
Gdzie komis traci najwięcej czasu
Zacznij od rozpisania czynności, które powtarzasz przy każdym samochodzie:
- Przyjęcie auta: dodajesz pojazd do bazy i przepisujesz jego identyfikatory.
- Opis do ogłoszenia: uzupełniasz silnik, skrzynię, napęd i wyposażenie.
- Wycena: szukasz wspólnego punktu odniesienia dla ceny zakupu i sprzedaży.
- Pytania kupującego: sprawdzasz historię, przeznaczenie auta i informacje serwisowe.

Każdy z tych kroków możesz zasilić danymi pobieranymi po VIN-ie, zamiast ponownie wprowadzać je ręcznie.
Nie musisz jednak pobierać wszystkiego dla każdego samochodu. Zakres zapytań możesz dopasować do etapu: najpierw identyfikacja i podstawowe dane, później wycena oraz historia wybranych aut.
Od numeru rejestracyjnego do VIN-u
Funkcja getVinByReg zwraca VIN po numerze rejestracyjnym. Kod kraju jest opcjonalny, a domyślnie przyjmowana jest Polska. W komisie możesz wykorzystać ją do dodania auta do bazy bez przepisywania całego VIN-u. Zapytanie kosztuje 0,20 EUR.
To ułatwienie przy przyjęciu, nie potwierdzenie tożsamości samochodu. Na placu nadal porównujesz uzyskany VIN z oznaczeniem na nadwoziu i dowodem.
Jeśli porządkujesz starszą bazę, przyda Ci się checkVinValid, za 0,02 EUR za zapytanie. Funkcja sprawdza poprawność VIN-u. Gdy znajdzie błąd, podaje najbardziej prawdopodobny poprawny numer oraz do trzech alternatyw.
Propozycji poprawki nie traktuj jako automatycznej zgody na zmianę danych. To pomoc przy weryfikacji wpisu przed kolejnymi płatnymi zapytaniami, a nie zamiennik porównania numeru z autem.
Dane techniczne i wyposażenie do ogłoszenia
Program dla komisu samochodowego może pobierać dane techniczne przez dwie funkcje. Ich zakres nie jest jednak taki sam:
getVinDecoder— 0,05 EUR: dane zapisane w VIN-ie przy produkcji, w tym marka, model, pojemność i moc silnika. Dla wielu aut także wyposażenie standardowe i dodatkowe.getVinCatalogSpec— 0,10 EUR: specyfikacja katalogowa dobrana do VIN-u: generacja, nadwozie, silnik, skrzynia, napęd, wymiary, masy, osiągi i spalanie.
Dekoder obsługuje marki europejskie, amerykańskie i azjatyckie, ale zakres oraz dokładność odpowiedzi zależą od pojazdu. Specyfikacja katalogowa opisuje natomiast wariant modelu, a nie fabryczny zapis konkretnego egzemplarza.
Jeśli pasuje ponad 50 wariantów katalogowych, auto nie zostaje dopasowane i zapytanie nie jest płatne. Przy przygotowywaniu opisu rozróżniaj więc dane egzemplarza od danych wariantu. Więcej o tym przeczytasz w poradniku jak sprawdzić wyposażenie auta po VIN-ie.
Wycena, która nie zależy od tego, kto ją robi
Wycena samochodu po VIN przez getVinValuation wymaga podania VIN-u, przebiegu i waluty. Zapytanie kosztuje 0,10 EUR i zwraca wartość minimalną, średnią, maksymalną oraz medianę.
Opcjonalnie otrzymasz też wyceny aut z sąsiednich roczników i z innym przebiegiem. Możesz więc korzystać ze wspólnego punktu odniesienia przy negocjacjach i ustalaniu ceny ogłoszenia, zamiast opierać proces wyłącznie na ocenie konkretnego handlowca.
Funkcja działa tak samo u każdego pracownika. Nie zastępuje jednak oceny stanu samochodu na placu: wynik traktuj jako punkt wyjścia, a nie gotową decyzję zakupową.
Tak wygląda skrócona przykładowa odpowiedź z wersji demo:
{
"functionName": "api/v3/getVinValuation",
"functionResponse": {
"valuation": {
"calcValuation": {
"price_min": 87820,
"price_med": 94780,
"price_avr": 98323,
"price_max": 112244
}
},
"userParams": {
"make": "KIA",
"model": "SORENTO",
"year": 2018,
"fuel": "DIESEL",
"odometer": 240000,
"currency": "PLN"
}
}
}
Historia, przeznaczenie i akcje serwisowe
Zanim pobierzesz pełną historię, możesz sprawdzić dostępny zakres informacji. Pozostałe funkcje dobierasz osobno — historia, przeznaczenie i obsługa serwisowa odpowiadają na inne pytania.
| Funkcja | Co zwraca | Kiedy przydaje się w komisie | Cena za zapytanie |
|---|---|---|---|
checkVinHistory |
Zakres dostępnych informacji dla VIN-u | Przed decyzją o pobraniu pełnej historii | 0,01 EUR |
getVinHistory |
Zmiany właścicieli, odczyty przebiegu, ceny z aukcji | Przy sprawdzaniu przeszłości auta | 1 EUR |
getVinStolenDatabases |
Wyniki sprawdzenia internetowych baz aut poszukiwanych i kradzionych w kilku krajach Europy | Przy dodatkowej weryfikacji przed zakupem | 0,50 EUR |
getVinPurpose |
Fabryczne przeznaczenie specjalne i dostępny kanał sprzedaży | Przy weryfikacji konfiguracji oraz sposobu sprzedaży auta | 0,20 EUR |
getVinRecalls |
Akcje dotyczące VIN-u albo modelu i rocznika | Przy sprawdzaniu informacji o akcjach serwisowych | 0,10 EUR |
getServiceSchedule |
Czynności na poprzedni, najbliższy i kolejny serwis według VIN-u i przebiegu | Przy sprawdzaniu zakresu obsługi serwisowej | 0,10 EUR |
Przy interpretacji odpowiedzi uwzględnij ograniczenia:
- Szkody:
getVinHistorynie obejmuje szkód ani baz kradzionych. Do szkód służą osobne funkcjecheckDamagesForVinigetDamagesForVin, wyceniane indywidualnie. - Bazy kradzionych: obecność na liście nie przesądza o kradzieży, a brak wpisu nie gwarantuje, że auto nie jest poszukiwane.
- Przeznaczenie:
getVinPurposeopisuje konfigurację fabryczną, nie późniejsze przeróbki. Kanał sprzedaży jest dostępny głównie dla marek Chrysler, Jeep, Dodge, Ram, GM i Mercedes-Benz. Płacisz przy znalezionym przeznaczeniu, wyraźnym zapisie „standardowe” albo kanale sprzedaży. - Akcje serwisowe po VIN: dane są niekompletne. Dla Polski obejmują akcje ogłoszone do listopada 2018 r., Wielkiej Brytanii do października 2025 r., a USA do maja 2024 r. To uzupełnienie, nie jedyne źródło — przy autach z Polski nadal ma sens sprawdzenie aktualnych akcji w ASO producenta. Brak wyników oznacza brak opłaty.
Ile to kosztuje — przykład
Załóżmy, że przyjmujesz ok. 40 aut miesięcznie. Dla każdego pobierasz ten sam zestaw podstawowych danych, a pełną historię zamawiasz po wstępnej selekcji dla ok. 25 samochodów.
| Funkcja | Cena za zapytanie | Koszt miesięczny |
|---|---|---|
getVinByReg |
0,20 EUR | 8 EUR |
getVinDecoder |
0,05 EUR | 2 EUR |
getVinValuation |
0,10 EUR | 4 EUR |
getVinRecalls |
0,10 EUR | 4 EUR |
checkVinHistory |
0,01 EUR | 0,40 EUR |
getVinHistory — ok. 25 aut |
1 EUR | 25 EUR |
| Razem | — | ok. 43 EUR |

Przy takim zestawie koszt rośnie z ok. 21 EUR dla 20 aut do ok. 43 EUR dla 40 i ok. 87 EUR dla 80 aut miesięcznie; największą pozycją pozostaje pełna historia.
Rozliczasz zapytania w euro. W razie błędu lub braku danych zapytanie jest bezpłatne. Odpowiedzi otrzymujesz w formacie JSON, a podłączeniem zajmuje się programista obsługujący Twój system.
Na anglojęzycznej stronie api.vin znajdziesz opisy i ceny funkcji, demo z przykładowymi odpowiedziami oraz formularz testowego klucza API. Jest też opis przetwarzania wsadowego: CSV na wejściu, plik JSON albo webhook na wyjściu. Taki tryb przydaje się do jednorazowego uzupełnienia danych całego placu.
Licencja Biznesowa czy API?
Wybór zależy od tego, czy chcesz udostępnić pracownikom raporty w przeglądarce, czy automatycznie pobierać dane do własnego systemu.
| Licencja Biznesowa | API | |
|---|---|---|
| Dla kogo | Dla Ciebie i pracowników sprawdzających auta lub pokazujących raport kupującemu | Dla komisu pobierającego dane do własnego programu |
| Jak korzystasz | Pełne raporty w przeglądarce, kodem licencji | Odpowiedzi JSON w Twoim systemie |
| Rozliczenie | Przedpłacony pakiet, bez osobnej płatności za każdy raport | Za zapytania, w euro |
| Czy potrzebny programista | Nie — korzystasz w przeglądarce | Tak — do podłączenia systemu |
| Kiedy wybrać | Gdy potrzebujesz raportów obsługiwanych przez pracowników | Gdy dane mają trafiać automatycznie do przyjęcia auta, ogłoszenia i wyceny |
Licencja Biznesowa autobaza.pl daje większy bonus na raporty przy większym pakiecie. Z opcją „FV zawsze” faktura VAT do każdego zakupu wystawia się automatycznie.
Rozsądnie zacząć od licencji, jeśli przede wszystkim sprawdzasz auta i pokazujesz raporty kupującym. Po API sięgnij, gdy rośnie liczba samochodów, a przepisywanie danych kosztuje Cię więcej niż samo sprawdzenie.
Sprawdź, jakie procedury serwisowe czekają na ten pojazd
Wpisz numer VIN i zobacz, co powinno być zrobione przy aktualnym przebiegu — zanim zapytasz sprzedawcę o książkę serwisową.
Najczęściej zadawane pytania
Jak pobrać VIN po numerze rejestracyjnym do programu komisu?
Ile kosztuje API do danych pojazdu?
Czy pełna historia przez API pokaże szkody?
Czym różni się Licencja Biznesowa od API?
Czy akcje serwisowe po VIN są kompletne?
Autobaza.pl to portal motoryzacyjny specjalizujący się w raportach VIN, historii pojazdów i poradach dla kierowców. Tworzymy rzetelne treści, które pomagają podejmować świadome decyzje przy zakupie i użytkowaniu samochodów. Nasza redakcja łączy pasję do motoryzacji z wieloletnim doświadczeniem, przedstawiając złożone zagadnienia w prosty i praktyczny sposób. Publikujemy analizy, poradniki oraz aktualności dotyczące bezpieczeństwa, ekologii i nowych trendów w branży. Regularnie współpracujemy z partnerami, przygotowując także treści o charakterze promocyjnym. Naszym celem jest wspieranie kierowców w lepszym zrozumieniu rynku motoryzacyjnego i codziennej eksploatacji pojazdów.
Powiązane artykuły

Koszty utrzymania samochodu: pierwszy rok po zakupie używanego auta

Cofnięty licznik — jak wykryć zaniżony przebieg

