AUTO-API.COM
Logo IAAI

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.

Oficjalne biblioteki SDK

Metody API są dostępne w naszych SDK jako gotowe funkcje, a otwarty kod bibliotek znajdziesz na GitHubie.

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.

API

Strumień /changes zwraca zdarzenia dla lotów IAAI: nowy lot, nowa cena Buy Now, wycofanie ze sprzedaży.

Codzienne eksporty

Codzienny eksport zawiera loty IAAI, które są w sprzedaży w dniu eksportu.

Pełne dane

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.

Uzyskaj dostęp do APIDostęp przyznany w ciągu 2 minut

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/iaai

Autoryzacja: api_key parametr

Schemat integracji

1
/filterspobierz dostępne wartości filtrów
2

Pierwsze pobranie:

/change_id?date=...pobierz początkowe ID dla strumienia zmian
/offerspobierz wszystkie loty strona po stronie
3
/changes?change_id=...pobierz wszystkie zmiany w bazie danych od podanego ID
4
/offerjeden lot według inner_id

Od 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_KEY

Odpowiedź:

{
  "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 strony
  • mark, model - marka i model jak w /filters, wielkość liter nie ma znaczenia
  • transmission_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 liter
  • year_from, year_to - rok modelowy od i do
  • km_age_from, km_age_to - przebieg w km od i do
  • price_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=15000

Odpowiedź:

{
  "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-10

Odpowiedź:

{
  "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=208412

Odpowiedź:

{
  "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~US

Odpowiedź 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ęty
  • 400 - brakuje wymaganego parametru lub wartość ma niewłaściwy format
  • 404 - 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:

https://{access_name}.auto-api.com/{date}/{file_name}

Parametry:

  • access_name - Twoja osobista subdomena
  • date - data eksportu w formacie rrrr-mm-dd, np. 2026-11-10
  • file_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.csv

Przykład polecenia Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
IAAI

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.

Odpowiedź w 2 min