AUTO-API.COM
Logo IAAI

IAAI APIScraper a parser

IAAI API: loty pojišťovacích autoaukcí USA a Kanady, cena Buy Now, odhady ACV a opravy, poškození, typ dokladu o vlastnictví, datum dražby. Feed změn a soubory.

Oficiální SDK knihovny

Metody API najdete v našich SDK jako hotové funkce, knihovny jsou open source na GitHubu.

IAAI API

Parser sbírá aukční loty z IAAI, pojišťovacích autoaukcí USA a Kanady, včetně osobních aut, SUV, pickupů a dodávek. Přes API můžete loty filtrovat podle požadavků kupujícího a sledovat je ve feedu změn až do stažení z prodeje. Psát a udržovat vlastní scraper iaai.com nemusíte.

API

Feed /changes vrací události k lotům IAAI: nový lot, nová cena Buy Now, stažení z prodeje.

Denní exporty

Denní export obsahuje loty IAAI, které jsou v den exportu v prodeji.

Kompletní data

Nájezd a status tachometru, motor a výkon, poškození, důvod prodeje, typ dokladu o vlastnictví, klíče a airbagy, datum dražby a pobočka, okruh oprávněných kupujících, fotky a video běžícího motoru.

Získat přístup k APIPřístup poskytnut do 2 minut

Lot má dvě čísla: inner_id, podle kterého lot načtete přes /offer, a stock_number, pod kterým ho znají kupující v dražbách IAAI.

Základní URL

https://{access_name}.auto-api.com/api/v3/iaai

Autorizace: api_key parametr

Pracovní postup

1
/filterszískat dostupné hodnoty filtrů
2

První načtení:

/change_id?date=...získat počáteční ID pro stream změn
/offerszískat všechny loty stránku po stránce
3
/changes?change_id=...získat všechny změny v databázi od daného ID
4
/offerjeden lot podle inner_id

Kde začít:

1. Před prvním načtením zjistěte z /change_id číslo pro dnešní datum a uložte si ho. Potom projděte /offers stránku po stránce až do konce: na poslední stránce má next_page hodnotu null.

2. Poté volejte /changes od tohoto čísla a předávejte next_change_id z každé odpovědi. Tak přicházejí nové loty, nové ceny Buy Now a stažení lotů z prodeje. Pokud má next_change_id hodnotu null, zatím nejsou žádné události: opakujte stejný požadavek později.

3. Pro vyhledávání podle vlastních kritérií volejte /offers s filtry.

Formát dat

  • Datové typy se zachovávají: číslo přichází jako číslo, seznam jako pole, chybějící hodnota jako null.
  • Časová razítka jsou v UTC, například "2026-11-12T14:30:00Z".
  • Cena, ACV a odhad nákladů na opravu jsou v měně lotu: USD u lotů z USA, CAD u lotů z Kanady.
  • Všechny loty mají stejnou sadu polí. Chybějící hodnota je null, například auction_at, dokud IAAI nestanoví datum dražby. Výjimkou je photos: u lotu bez fotek je to prázdné pole.

GET/filters

Vrací všechny možné hodnoty pro filtrování

https://{access_name}.auto-api.com/api/v3/iaai/filters?api_key=YOUR_API_KEY

Odpověď:

{
  "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 po stránkách, výběr lze zúžit filtry.

Parametry:

  • page (povinné) - číslo stránky
  • mark, model - značka a model jako v /filters, na velikosti písmen nezáleží
  • transmission_type, color, body_type, engine_type, drive_type - hodnoty převodovky, barvy, karoserie, paliva a pohonu z /filters, bez rozlišení velikosti písmen
  • year_from, year_to - modelový rok od a do
  • km_age_from, km_age_to - nájezd v km od a do
  • price_from, price_to - cena Buy Now od a do v měně lotu. Loty bez Buy Now těmto filtrům neodpovídají

Chcete-li do filtru předat více hodnot, zopakujte parametr s hranatými závorkami: 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

Odpověď:

{
  "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": {  // původní hodnoty 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"]
        }
      }
    }
    // ... dále ostatní loty, až 20 na stránce
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Datová pole:

Lot

id - interní ID databáze

inner_id - ID lotu z odkazu na IAAI s označením trhu za vlnovkou: "43963919~US", u kanadských lotů ve tvaru "Imp_3139055~CA". Toto ID přijímá /offer.

stock_number - Stock#, číslo lotu, které IAAI ukazuje na svém webu a v dražbě.

url - Odkaz na lot.

price, currency - Cena Buy Now a měna, USD nebo CAD. Pokud lot cenu Buy Now nemá, je price null.

acv - ACV, odhad hodnoty vozu před poškozením.

repair_cost - Odhad nákladů na opravu.

section - Vždy "Used".

description - Popis od prodejce. Loty IAAI ho nemají, proto má vždy hodnotu null.

created_at - Čas, kdy se lot dostal do naší databáze.

offer_created - Čas vystavení lotu podle IAAI. IAAI ho aktualizuje, například když je lot vystaven znovu nebo se dražba přesune, takže může být pozdější než created_at.

Vůz

mark, model - Značka a model tak, jak je píše IAAI: "CHEVROLET", "TAHOE".

complectation - Výbavová verze, například "2WD LT".

year - Modelový rok.

first_registration - První registrace. IAAI ji nezveřejňuje, proto má vždy hodnotu null.

vin - VIN v podobě, v jaké ho ukazuje IAAI: prvních 11 znaků, zbytek je skrytý pod hvězdičkami.

km_age - Nájezd v km. Pokud IAAI místo nájezdu uvádí 0 nebo 1 (tachometr nejde odečíst, nefunguje nebo se nájezd nevykazuje), je hodnota null.

odometer, odometer_unit - Údaj tachometru podle IAAI a jeho jednotka: "mi" (míle) nebo "km".

odometer_status - Status tachometru, například "Actual", "Not actual", "Exceeds mechanical limits" nebo "Exempt" (starší vozy nájezd vykazovat nemusí).

owners_count - Počet majitelů. IAAI ho nezveřejňuje, proto má vždy hodnotu null.

vehicle_type - Typ vozidla podle klasifikace IAAI, například "Automobile", "Light truck" nebo "Classic car". Typ karoserie přichází v body_type.

country_of_origin - Země montáže.

Technické údaje

engine_type - Palivo: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" nebo "Other".

transmission_type - "Automatic", "Manual" nebo "CVT".

body_type - Typ karoserie, například "SUV" nebo "Pickup". Označení karoserie tak, jak ho píše IAAI, je v original.body_type.

drive_type - Pohon: "FWD", "RWD", "AWD" nebo "4WD". "4x2" znamená, že IAAI neuvedl, která náprava je hnací.

color, interior_color - Barva karoserie a barva interiéru.

displacement, displacement_cc - Zdvihový objem motoru v litrech podle IAAI a tentýž objem v cm³ (5,3 l odpovídá 5300).

engine - Motor tak, jak ho popisuje IAAI, například "5.3L V-8 DI, VVT, 355HP".

cylinders - Počet válců.

power - Výkon v koních. U hybridů a elektromobilů je hodnota null: celkový systémový výkon IAAI nezveřejňuje.

power_ice_hp - Výkon spalovacího motoru v koních. U hybridů je vyplněn, i když je power null.

power_electro_kw, seat_count - Výkon elektromotoru a počet míst. IAAI je nezveřejňuje, proto mají vždy hodnotu null.

Poškození a doklad o vlastnictví

primary_damage, secondary_damage - Hlavní a vedlejší poškození, například "Front end", "Left side", "Flood" nebo "Hail".

loss_type - Proč se vůz dostal do aukce: "Collision", "Theft", "Flood", "Fire" nebo "Other".

condition - Údaj o nastartování: "Run & drive", "Starts", "Stationary" nebo "Can't test".

has_keys - Zda jsou k vozu klíče (true/false).

airbags - Stav airbagů, například "Intact", "Deployed" nebo "Missing".

restraint_system - Airbagy a bezpečnostní pásy, kterými je vůz vybaven.

catalytic_converter - Katalyzátor je na místě (true), nebo byl odstraněn (false).

title_group - Typ dokladu o vlastnictví: "Clear", "Salvage", "Non-repairable" a další. U kanadských lotů přichází tak, jak ho píše IAAI, například "ON-NOT BRANDED-ONTARIO". Dokud IAAI doklad neobdrží, je hodnota null.

title_state - Stát nebo provincie, která doklad o vlastnictví vydala.

title_brand, title_notes - Označení a poznámky v dokladu o vlastnictví tak, jak je píše IAAI, například "PREVIOUS SALVAGE".

declarations - Prohlášení prodejce u kanadských lotů, text tak, jak ho píše IAAI, například "TKU" (skutečný nájezd není znám) nebo odkaz na zprávu CARFAX.

Dražba, prodejce a místo

auction_at - Začátek živé dražby. Dokud IAAI datum nestanoví, je hodnota null. Stanovení ani přesunutí data dražby nevytváří událost v /changes. /offer a /offers vracejí poslední naplánované datum a čas dražby.

auction_type - "Live auction" nebo "Timed auction".

timed_auction_close_at - Konec dražby s časovým limitem.

branch, branch_id - Pobočka IAAI, kde se lot prodává, a číslo pobočky.

lane, run_number - Aukční řada (lane) a pořadové číslo lotu v ní. IAAI je přiděluje krátce před dražbou, do té doby je hodnota null. Stejně jako datum dražby nepřicházejí v /changes jako samostatné události.

is_public - true, pokud lot mohou koupit i kupující z řad veřejnosti (označení Public). Kdo další může lot koupit, je uvedeno v poli who_can_buy.

who_can_buy - Kdo může lot koupit: "Dealers", "Dismantlers", "Exporters", "Public" a další. IAAI seznam vyplňuje blíže k dražbě, do té doby je hodnota null.

seller_category - Odkud se vůz dostal do aukce: "Insurance company", "Remarketing", "Lease and rental", "Repossession" a další.

seller_type, is_dealer, salon_id - Prodejce. IAAI ho neukazuje, proto mají tato pole vždy hodnotu null.

country - "USA" nebo "Canada".

region, city - Stát nebo provincie a město, kde vůz stojí.

address, zip - Adresa a PSČ téhož místa.

latitude, longitude - Souřadnice téhož místa. U kanadských lotů je hodnota null.

Fotky, videa a referenční údaje

photos - Odkazy na fotky v plné velikosti. U lotu bez fotek je to prázdné pole.

photo_360_url - Odkaz na pohled 360° na webu IAAI.

engine_video_url - Odkaz na video běžícího motoru.

options - Výbava tak, jak ji uvádí IAAI, v jedné skupině "Equipment".

original - Původní hodnoty hlavních polí z iaai.com, bez překladu.

catalog_ids - Kódy katalogu. IAAI je nezveřejňuje, proto jsou hodnoty vždy null.

GET/change_id

Získat první ID změny podle data (pro použití v /changes)

Parametry:

  • date (povinné) - datum ve formátu yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10

Odpověď:

{
  "change_id": 208400
}

Použijte vrácenou hodnotu jako parametr change_id v /changes

GET/changes

Stream změn (přidáno/změněno/odstraněno)

Parametry:

  • change_id (povinné) - od kterého ID změny
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412

Odpověď:

{
  "result": [
    {
      "id": 208412,
      "inner_id": "46237543~US",
      "change_type": "changed",
      "created_at": "2026-11-10T03:12:40Z",
      "data": {  // nová cena Buy Now v měně lotu (null, pokud byla cena Buy Now zrušena)
        "new_price": 28225
      }
    },
    {
      "id": 208413,
      "inner_id": "47020463~US",
      "change_type": "added",
      "created_at": "2026-11-10T03:12:41Z",
      "data": { ... }  // celý záznam lotu, jako v /offers
    },
    {
      "id": 208414,
      "inner_id": "46769371~US",
      "change_type": "removed",
      "created_at": "2026-11-10T03:12:43Z",
      "data": {}  // lot stažen z prodeje
    }
    // ... dále ostatní události, až 20 na stránce
  ],
  "meta": {
    "cur_change_id": 208412,
    "next_change_id": 208432,
    "limit": 20
  }
}

GET/offer

Jeden lot podle inner_id.

Parametry:

  • inner_id (povinné)
https://{access_name}.auto-api.com/api/v3/iaai/offer?api_key=YOUR_API_KEY&inner_id=43963919~US

Odpověď obsahuje jen objekt data, bez obalu result.

Chyby

Při chybě obsahuje odpověď pole error s popisem: { "error": "parameter page is required" }

  • 401 - klíč api_key nebyl přijat
  • 400 - chybí povinný parametr nebo má hodnota nesprávný formát
  • 404 - lot s tímto inner_id nebyl nalezen (/offer)
  • 429 - limit požadavků je vyčerpán

Uchování

Soubory zůstávají dostupné nejméně 3 dny

Dostupnost

Nové soubory každé ráno

Formát CSV

Sloupce CSV jsou odděleny znakem svislítko (|)

Struktura URL:

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

Parametry:

  • access_name - vaše osobní subdoména
  • date - datum exportu ve formátu rrrr-mm-dd, např. 2026-11-10
  • file_name - název souboru s příponou

Dostupné soubory:

  • 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

Příklad požadavku 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

Příklad příkazu Wget

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

IAAI (iaai.com) je web aukcí Insurance Auto Auctions (IAA). Od roku 2023 je společnost součástí RB Global. Vozy do aukcí v USA a Kanadě dávají pojišťovny po nehodě, zatopení, požáru nebo krádeži a také banky, dealeři, leasingové společnosti a autopůjčovny.

Lot se prodává v živé dražbě ve stanovený den nebo v dražbě s časovým limitem a část lotů lze koupit ještě před dražbou za cenu Buy Now. Některé loty se prodávají jen kupujícím s licencí, například dealerům, autovrakovištím a exportérům, zatímco loty s označením Public jsou dostupné i veřejnosti. Příhozy ani prodejní ceny IAAI nezveřejňuje.

Dovozce v lotu vidí, zda ho smějí koupit exportéři. Podle modelového roku, objemu a výkonu motoru lze odhadnout dovozní clo a podle prvních 11 znaků VIN ověřit model a výrobní závod.

Přes /changes přicházejí nové loty, nové ceny Buy Now a stažení z prodeje. Stažení z prodeje neznamená vždy, že byl lot prodán.

Odpovíme do 2 minut