
IAAI APIScraper i parser
IAAI API: aukcje ubezpieczeniowe z USA i Kanady. Cena Buy Now, ACV i wycena naprawy, uszkodzenia, rodzaj dokumentu, data licytacji. Strumień zmian i pliki.
IAAI API
Parser zbiera z IAAI, ubezpieczeniowych aukcji samochodowych w USA i Kanadzie, loty samochodów osobowych, SUV-ów, pickupów i furgonów. Przez API możesz filtrować loty zgodnie z wymaganiami kupującego i śledzić je w strumieniu zmian aż do wycofania ze sprzedaży. Nie musisz pisać ani utrzymywać własnego scrapera iaai.com.
Strumień /changes zwraca zdarzenia dla lotów IAAI: nowy lot, nowa cena Buy Now, wycofanie ze sprzedaży.
Codzienny eksport zawiera loty IAAI, które są w sprzedaży w dniu eksportu.
Przebieg i status wskazania licznika, silnik i moc, uszkodzenia, przyczyna sprzedaży, rodzaj dokumentu własności, kluczyki i poduszki powietrzne, data licytacji i oddział, uprawnieni kupujący, zdjęcia i nagranie pracy silnika.
Lot ma dwa numery: inner_id, według którego pobierasz lot z /offer, i stock_number, pod którym kupujący znają go na aukcjach IAAI.
Bazowy URL
https://{access_name}.auto-api.com/api/v3/iaaiAutoryzacja: api_key parametr
Schemat integracji
/filterspobierz dostępne wartości filtrówPierwsze pobranie:
/change_id?date=...pobierz początkowe ID dla strumienia zmian/offerspobierz wszystkie loty strona po stronie/changes?change_id=...pobierz wszystkie zmiany w bazie danych od podanego ID/offerjeden lot według inner_idOd czego zacząć:
1. Przed pierwszym pobraniem odczytaj z /change_id numer dla dzisiejszej daty i zapisz go. Następnie przejdź przez /offers strona po stronie aż do końca: na ostatniej stronie next_page ma wartość null.
2. Potem odpytuj /changes od tego numeru, przekazując next_change_id z każdej odpowiedzi. Tak przychodzą nowe loty, nowe ceny Buy Now i wycofania lotów ze sprzedaży. Jeśli next_change_id ma wartość null, zdarzeń jeszcze nie ma: powtórz to samo żądanie później.
3. Aby wyszukiwać według własnych kryteriów, wywołuj /offers z filtrami.
Format danych
- Typy są zachowane: liczba przychodzi jako liczba, lista jako tablica, brakująca wartość jako null.
- Znaczniki czasu są w UTC, np. "2026-11-12T14:30:00Z".
- Cena, ACV i szacunkowy koszt naprawy są podane w walucie lotu: USD w lotach z USA, CAD w lotach z Kanady.
- Wszystkie loty mają ten sam zestaw pól. Brakująca wartość to null, np. w auction_at, dopóki IAAI nie wyznaczy daty licytacji. Wyjątkiem jest photos: dla lotu bez zdjęć to pusta tablica.
GET/filters
Zwraca wszystkie możliwe wartości do filtrowania
https://{access_name}.auto-api.com/api/v3/iaai/filters?api_key=YOUR_API_KEYOdpowiedź:
{
"mark": {
"CHEVROLET": { "model": [..., "TAHOE", "TAHOE HYBRID", "TAHOE K1500", "TRACKER", "TRAILBLAZER", ...] },
"FORD": { "model": [..., "EXPEDITION", "EXPEDITION EL", "EXPEDITION MAX", "EXPLORER", "EXPLORER SPORT", ...] },
"TOYOTA": { "model": [..., "RAV4 HYBRID", "RAV4 PLUG-IN HYBRID", "RAV4 PRIME", "RAV4 SE HYBRID", ...] },
...
},
"transmission_type": ["Automatic", "CVT", "Manual"],
"color": ["Beige", "Black", "Blue", "Brown", ...],
"body_type": [..., "Passenger van", "Pickup", "QUATTRO COUPE", "Roadster", ...],
"engine_type": ["Diesel", "Electric", "Flex fuel", "Gasoline", "Hybrid", "Other"],
"drive_type": ["4WD", "4x2", "AWD", ..., "FWD", ..., "RWD"]
}GET/offers
Loty strona po stronie. Filtry zawężają wyniki.
Parametry:
page(wymagane) - numer stronymark, model- marka i model jak w /filters, wielkość liter nie ma znaczeniatransmission_type, color, body_type, engine_type, drive_type- skrzynia biegów, kolor, nadwozie, paliwo i napęd według wartości z /filters, bez rozróżniania wielkości literyear_from, year_to- rok modelowy od i dokm_age_from, km_age_to- przebieg w km od i doprice_from, price_to- cena Buy Now od i do, w walucie lotu. Loty bez Buy Now nie pasują do tych filtrów
Aby przekazać do filtra kilka wartości, powtórz parametr z nawiasami kwadratowymi: mark[]=CHEVROLET&mark[]=FORD
https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&mark=CHEVROLET&model=TAHOE&year_from=2020https://{access_name}.auto-api.com/api/v3/iaai/offers?api_key=YOUR_API_KEY&page=1&body_type=Pickup&price_to=15000Odpowiedź:
{
"result": [
{
"id": 61842,
"inner_id": "43963919~US",
"change_type": "added",
"created_at": "2026-10-25T05:41:52Z",
"data": {
"id": 61842,
"inner_id": "43963919~US",
"stock_number": "43468982",
"url": "https://www.iaai.com/VehicleDetail/43963919~US",
"mark": "CHEVROLET",
"model": "TAHOE",
"complectation": "2WD LT",
"year": 2021,
"first_registration": null,
"km_age": 187368,
"odometer": 116425,
"odometer_unit": "mi",
"odometer_status": "Not actual",
"owners_count": null,
"price": 14000,
"currency": "USD",
"acv": 38323,
"repair_cost": 25348,
"engine_type": "Gasoline",
"transmission_type": "Automatic",
"body_type": "SUV",
"drive_type": "4x2",
"color": "Gray",
"interior_color": null,
"displacement": 5.3,
"displacement_cc": 5300,
"engine": "5.3L V-8 DI, VVT, 355HP",
"cylinders": 8,
"power": 355,
"power_ice_hp": 355,
"power_electro_kw": null,
"seat_count": null,
"section": "Used",
"seller_type": null,
"is_dealer": null,
"salon_id": null,
"seller_category": "Insurance company",
"region": "Georgia",
"city": "Winder",
"address": "1045 Atlanta Hwy SE",
"zip": "30680",
"latitude": 33.97598,
"longitude": -83.6573,
"description": null,
"created_at": "2026-10-25T05:41:52Z",
"offer_created": "2026-10-25T05:33:28Z",
"photos": [
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I1~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I2~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I3~RW2576~H1932~TH0&width=2576&height=1932",
"https://vis.iaai.com/resizer?imageKeys=43963919~SID~B707~S0~I4~RW2576~H1932~TH0&width=2576&height=1932",
...
],
"photo_360_url": "https://vis.iaai.com/Home/ThreeSixtyView?keys=SID-43963919~STP-1~INT-1&iframeview=true",
"engine_video_url": "https://mediastorageaccountprod.blob.core.windows.net/media/43963919_VES-100_1",
"vin": "1GNSCNKD0MR******",
"auction_at": "2026-11-12T14:30:00Z",
"auction_type": "Live auction",
"timed_auction_close_at": null,
"branch": "Atlanta East",
"branch_id": "707",
"lane": "D",
"run_number": 153,
"country": "USA",
"primary_damage": "Right rear",
"secondary_damage": "Rear",
"loss_type": "Collision",
"title_group": "Salvage",
"title_state": "Georgia",
"title_brand": null,
"title_notes": null,
"condition": "Run & drive",
"has_keys": true,
"airbags": "Intact",
"catalytic_converter": true,
"is_public": true,
"who_can_buy": ["Dealers", "Dismantlers", "Exporters", "Other licensed businesses", "Non-auto licensed businesses", "Public", "Rebuilders", "Scrappers"],
"vehicle_type": "SUV",
"country_of_origin": "USA",
"restraint_system": ["Driver front airbag", "Driver side airbag", "Curtain airbags", "Passenger front airbag", "Passenger side airbag", "Front center airbag"],
"declarations": null,
"original": { // oryginalne wartości z iaai.com
"mark": "CHEVROLET",
"model": "TAHOE",
"complectation": "2WD LT",
"engine_type": "GASOLINE",
"transmission_type": "AUTOMATIC",
"body_type": "UTILITY",
"drive_type": "4X2 DRIVE",
"color": "GRAY",
"interior_color": null,
"primary_damage": "Right Rear",
"secondary_damage": "Rear",
"loss_type": "Collision",
"title_group": "Salvage",
"condition": "Run & Drive",
"region": "GA"
},
"catalog_ids": {
"mark": null,
"model": null,
"complectation": null
},
"options": {
"Equipment": ["Console display"]
}
}
}
// ... dalej pozostałe loty, do 20 na stronie
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Pola danych:
Lot
id - wewnętrzne ID bazy danych
inner_id - ID lotu z linku na IAAI z oznaczeniem rynku po tyldzie: "43963919~US", a dla lotów kanadyjskich w postaci "Imp_3139055~CA". Właśnie to ID przyjmuje /offer.
stock_number - Stock#, numer lotu, który IAAI pokazuje na swojej stronie i na aukcji.
url - Link do lotu.
price, currency - Cena Buy Now i waluta, USD lub CAD. Jeśli lot nie ma ceny Buy Now, price ma wartość null.
acv - ACV, szacunkowa wartość auta przed uszkodzeniem.
repair_cost - Szacunkowy koszt naprawy.
section - Zawsze "Used".
description - Opis napisany przez sprzedawcę. Loty IAAI go nie mają, dlatego pole ma zawsze wartość null.
created_at - Czas, w którym lot trafił do naszej bazy.
offer_created - Czas wystawienia lotu podany przez IAAI. IAAI go aktualizuje, np. przy ponownym wystawieniu lotu lub przeniesieniu licytacji na inny termin, dlatego może być późniejszy niż created_at.
Auto
mark, model - Marka i model tak, jak zapisuje je IAAI: "CHEVROLET", "TAHOE".
complectation - Wersja wyposażenia, np. "2WD LT".
year - Rok modelowy.
first_registration - Pierwsza rejestracja. IAAI jej nie publikuje, dlatego pole ma zawsze wartość null.
vin - VIN w takiej postaci, w jakiej pokazuje go IAAI: pierwsze 11 znaków, a reszta jest ukryta pod gwiazdkami.
km_age - Przebieg w km. Jeśli zamiast przebiegu IAAI podaje 0 lub 1 (licznik jest nieczytelny, nie działa albo przebieg jest zwolniony z obowiązku podawania), null.
odometer, odometer_unit - Wskazanie licznika jak na IAAI i jego jednostka: "mi" (mile) lub "km".
odometer_status - Status wskazania licznika, np. "Actual", "Not actual", "Exceeds mechanical limits" lub "Exempt" (starsze auta są zwolnione z obowiązku podawania przebiegu).
owners_count - Liczba właścicieli. IAAI jej nie publikuje, dlatego pole ma zawsze wartość null.
vehicle_type - Typ pojazdu według klasyfikacji IAAI, np. "Automobile", "Light truck" lub "Classic car". Typ nadwozia przychodzi w body_type.
country_of_origin - Kraj montażu.
Parametry techniczne
engine_type - Paliwo: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" lub "Other".
transmission_type - "Automatic", "Manual" lub "CVT".
body_type - Typ nadwozia, np. "SUV" lub "Pickup". Nazwa nadwozia w zapisie IAAI jest w original.body_type.
drive_type - Napęd: "FWD", "RWD", "AWD" lub "4WD". "4x2" oznacza, że IAAI nie podaje, która oś jest napędzana.
color, interior_color - Kolor nadwozia i kolor wnętrza.
displacement, displacement_cc - Pojemność silnika w litrach, tak jak podaje ją IAAI, i ta sama pojemność w cm³ (5.3 l to 5300).
engine - Silnik tak, jak opisuje go IAAI, np. "5.3L V-8 DI, VVT, 355HP".
cylinders - Liczba cylindrów.
power - Moc w KM. W hybrydach i autach elektrycznych null: IAAI nie publikuje łącznej mocy systemowej.
power_ice_hp - Moc silnika spalinowego w KM. W hybrydach jest podana, nawet gdy power ma wartość null.
power_electro_kw, seat_count - Moc silnika elektrycznego i liczba miejsc. IAAI ich nie publikuje, dlatego pola mają zawsze wartość null.
Uszkodzenia i dokument własności
primary_damage, secondary_damage - Uszkodzenie główne i dodatkowe, np. "Front end", "Left side", "Flood" lub "Hail".
loss_type - Dlaczego auto trafiło na aukcję: "Collision", "Theft", "Flood", "Fire" lub "Other".
condition - Status uruchomienia: "Run & drive", "Starts", "Stationary" lub "Can't test".
has_keys - Czy są kluczyki (true/false).
airbags - Stan poduszek powietrznych, np. "Intact", "Deployed" lub "Missing".
restraint_system - Poduszki powietrzne i pasy bezpieczeństwa, w które wyposażone jest auto.
catalytic_converter - Katalizator na miejscu (true) lub usunięty (false).
title_group - Rodzaj dokumentu własności: "Clear", "Salvage", "Non-repairable" i inne. W lotach kanadyjskich przychodzi tak, jak zapisuje go IAAI, np. "ON-NOT BRANDED-ONTARIO". Dopóki dokument nie dotrze do IAAI, null.
title_state - Stan lub prowincja wydania dokumentu własności.
title_brand, title_notes - Adnotacja w dokumencie własności i uwagi tak, jak zapisuje je IAAI, np. "PREVIOUS SALVAGE".
declarations - Deklaracje sprzedawcy w lotach kanadyjskich, tekst tak, jak zapisuje go IAAI, np. "TKU" (rzeczywisty przebieg w kilometrach nieznany) lub wzmianka o raporcie CARFAX.
Licytacja, sprzedawca i lokalizacja
auction_at - Początek licytacji na żywo. Dopóki IAAI nie wyznaczy daty, null. Wyznaczenie lub przeniesienie daty licytacji nie tworzy zdarzenia w /changes. /offer i /offers zwracają aktualną zaplanowaną datę i godzinę licytacji.
auction_type - "Live auction" lub "Timed auction".
timed_auction_close_at - Koniec licytacji czasowej.
branch, branch_id - Oddział IAAI, w którym sprzedawany jest lot, i numer oddziału.
lane, run_number - Linia aukcyjna (lane) i numer lotu w kolejce na tej linii. IAAI nadaje je krótko przed licytacją, wcześniej null. Podobnie jak data licytacji, nie przychodzą jako osobne zdarzenia w /changes.
is_public - true, jeśli lot jest dostępny dla osób prywatnych (oznaczenie Public). Kto jeszcze może kupić lot, podano w who_can_buy.
who_can_buy - Kto może kupić lot: "Dealers", "Dismantlers", "Exporters", "Public" i inne. IAAI uzupełnia listę bliżej licytacji, wcześniej null.
seller_category - Skąd auto trafiło na aukcję: "Insurance company", "Remarketing", "Lease and rental", "Repossession" i inne.
seller_type, is_dealer, salon_id - Sprzedawca. IAAI go nie pokazuje, dlatego te pola mają zawsze wartość null.
country - "USA" lub "Canada".
region, city - Stan lub prowincja oraz miasto, gdzie stoi auto.
address, zip - Adres i kod ZIP lub kod pocztowy tego samego miejsca.
latitude, longitude - Współrzędne tego samego miejsca. W lotach kanadyjskich null.
Zdjęcia, filmy i dane referencyjne
photos - Linki do zdjęć w pełnym rozmiarze. Dla lotu bez zdjęć pusta tablica.
photo_360_url - Link do widoku 360 na stronie IAAI.
engine_video_url - Link do nagrania pracy silnika.
options - Wyposażenie tak, jak wymienia je IAAI, w jednej grupie "Equipment".
original - Oryginalne wartości głównych pól z iaai.com, bez tłumaczenia.
catalog_ids - Kody katalogowe. IAAI ich nie publikuje, dlatego wartości są zawsze null.
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/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10Odpowiedź:
{
"change_id": 208400
}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/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412Odpowiedź:
{
"result": [
{
"id": 208412,
"inner_id": "46237543~US",
"change_type": "changed",
"created_at": "2026-11-10T03:12:40Z",
"data": { // nowa cena Buy Now w walucie lotu (null, jeśli Buy Now usunięto)
"new_price": 28225
}
},
{
"id": 208413,
"inner_id": "47020463~US",
"change_type": "added",
"created_at": "2026-11-10T03:12:41Z",
"data": { ... } // pełne dane lotu, jak w /offers
},
{
"id": 208414,
"inner_id": "46769371~US",
"change_type": "removed",
"created_at": "2026-11-10T03:12:43Z",
"data": {} // lot wycofany ze sprzedaży
}
// ... dalej pozostałe zdarzenia, do 20 na stronie
],
"meta": {
"cur_change_id": 208412,
"next_change_id": 208432,
"limit": 20
}
}GET/offer
Jeden lot według inner_id.
Parametry:
inner_id(wymagane)
https://{access_name}.auto-api.com/api/v3/iaai/offer?api_key=YOUR_API_KEY&inner_id=43963919~USOdpowiedź zawiera tylko obiekt data, bez opakowania w result.
Błędy
W razie błędu odpowiedź zawiera pole error z opisem: { "error": "parameter page is required" }
401- klucz api_key nie został przyjęty400- brakuje wymaganego parametru lub wartość ma niewłaściwy format404- nie ma lotu o takim inner_id (/offer)429- limit żądań został wyczerpany
Przechowywanie
Pliki pozostają dostępne przez co najmniej 3 dni
Dostępność
Świeże pliki każdego ranka
Format CSV
Kolumny CSV są rozdzielone znakiem pipe (|)
Struktura URL:
Parametry:
access_name- Twoja osobista subdomenadate- data eksportu w formacie rrrr-mm-dd, np. 2026-11-10file_name- nazwa pliku z rozszerzeniem
Dostępne pliki:
- 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
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 polecenia Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'IAAI (iaai.com) to serwis aukcji Insurance Auto Auctions (IAA). Od 2023 roku firma należy do RB Global. Auta na aukcje w USA i Kanadzie oddają firmy ubezpieczeniowe po kolizji, zalaniu, pożarze lub kradzieży, a także banki, dealerzy, firmy leasingowe i wypożyczalnie samochodów.
Lot jest sprzedawany na licytacji na żywo w wyznaczonym dniu albo na licytacji czasowej, a część lotów można kupić przed licytacją po cenie Buy Now. Niektóre loty są sprzedawane tylko kupującym z licencją, np. dealerom, stacjom demontażu pojazdów i eksporterom, a loty z oznaczeniem Public są dostępne także dla osób prywatnych. IAAI nie podaje publicznie składanych ofert ani cen sprzedaży.
Importer widzi w danych lotu, czy mogą go kupić eksporterzy. Na podstawie roku modelowego, pojemności i mocy silnika oszacujesz cło, a po pierwszych 11 znakach VIN sprawdzisz model i zakład produkcyjny.
Przez /changes przychodzą nowe loty, nowe ceny Buy Now i wycofania ze sprzedaży. Wycofanie ze sprzedaży nie zawsze oznacza, że lot został sprzedany.
Rozszerz swój zasięg danych motoryzacyjnych na rynki globalne dzięki naszym wszechstronnym interfejsom API dla platform: