
IAAI APIScraper & Parser
IAAI API: Lose US- und kanadischer Versicherungsauktionen mit Buy Now-Preis, ACV, Reparaturschätzung, Schäden, Eigentumsnachweis, Auktionstermin. Feed, Dateien.
IAAI API
Der Parser erfasst Auktionslose von IAAI, den Versicherungsauktionen der USA und Kanadas, darunter Pkw, SUVs, Pick-ups und Vans. Mit der API können Sie die Lose nach den Vorgaben eines Käufers filtern und über den Änderungsfeed verfolgen, bis sie aus dem Verkauf genommen werden. Einen eigenen Scraper für iaai.com müssen Sie nicht entwickeln und pflegen.
Der Feed /changes liefert Ereignisse zu den Losen von IAAI: neues Los, neuer Buy Now-Preis, aus dem Verkauf genommen.
Der tägliche Export enthält die Lose von IAAI, die am Exportdatum im Verkauf sind.
Laufleistung und Status des Tachostands, Motor und Leistung, Schäden, Verkaufsgrund, Art des Eigentumsnachweises, Fahrzeugschlüssel und Airbags, Auktionstermin und Niederlassung, zugelassene Käufer, Fotos und Motorvideo.
Ein Los hat zwei Nummern: inner_id, mit der Sie das Los über /offer abrufen, und stock_number, unter der Käufer es bei den Auktionen von IAAI kennen.
Basis-URL
https://{access_name}.auto-api.com/api/v3/iaaiAutorisierung: api_key Parameter
Arbeitsablauf
/filtersverfügbare Filterwerte abrufenErstes Laden:
/change_id?date=...Start-ID für Änderungs-Feed abrufen/offersalle Lose Seite für Seite abrufen/changes?change_id=...alle Änderungen in der Datenbank ab ID abrufen/offerein einzelnes Los per inner_idSo starten Sie:
1. Holen Sie vor dem ersten Laden die Nummer aus /change_id zum heutigen Datum und speichern Sie sie. Gehen Sie danach /offers Seite für Seite bis zum Ende durch: Auf der letzten Seite ist next_page null.
2. Rufen Sie anschließend /changes ab dieser Nummer regelmäßig auf und übergeben Sie jedes Mal next_change_id aus der Antwort. So erhalten Sie neue Lose, neue Buy Now-Preise und Lose, die aus dem Verkauf genommen wurden. Ist next_change_id null, gibt es noch keine Ereignisse: Wiederholen Sie dieselbe Anfrage später.
3. Für eine Suche nach eigenen Kriterien rufen Sie /offers mit Filtern auf.
Datenformat
- Die Datentypen bleiben erhalten: Eine Zahl kommt als Zahl, eine Liste als Array, ein fehlender Wert als null.
- Zeitstempel sind in UTC angegeben, z. B. "2026-11-12T14:30:00Z".
- Preis, ACV und geschätzte Reparaturkosten sind in der Währung des Loses angegeben: USD bei Losen aus den USA, CAD bei Losen aus Kanada.
- Jedes Los hat dieselben Felder. Ein fehlender Wert ist null, z. B. auction_at, solange IAAI den Auktionstermin nicht festgelegt hat. Eine Ausnahme ist photos: Bei einem Los ohne Fotos steht dort ein leeres Array.
GET/filters
Gibt alle möglichen Werte zum Filtern zurück
https://{access_name}.auto-api.com/api/v3/iaai/filters?api_key=YOUR_API_KEYAntwort:
{
"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
Lose Seite für Seite. Mit Filtern lässt sich die Auswahl eingrenzen.
Parameter:
page(erforderlich) - Seitennummermark, model- Marke und Modell wie in /filters, Groß-/Kleinschreibung wird ignorierttransmission_type, color, body_type, engine_type, drive_type- Getriebe, Farbe, Karosserie, Kraftstoff und Antrieb mit den Werten aus /filters, Groß-/Kleinschreibung wird ignoriertyear_from, year_to- Modelljahr von und biskm_age_from, km_age_to- Laufleistung in km von und bisprice_from, price_to- Buy Now-Preis von und bis in der Währung des Loses. Lose ohne Buy Now erfüllen diese Filter nicht
Um mehrere Werte an einen Filter zu übergeben, wiederholen Sie den Parameter mit eckigen Klammern: 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=15000Antwort:
{
"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": { // Originalwerte von 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"]
}
}
}
// ... danach die übrigen Lose, bis zu 20 pro Seite
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Datenfelder:
Los
id - interne Datenbank-ID
inner_id - Los-ID aus dem Link auf IAAI mit dem Markt nach der Tilde: "43963919~US", bei kanadischen Losen in der Form "Imp_3139055~CA". Diese ID akzeptiert /offer.
stock_number - Stock#, die Losnummer, die IAAI auf seiner Website und bei der Auktion anzeigt.
url - Link zum Los.
price, currency - Buy Now-Preis und Währung, USD oder CAD. Hat das Los keinen Buy Now-Preis, ist price null.
acv - ACV, der geschätzte Wert des Fahrzeugs vor dem Schaden.
repair_cost - Geschätzte Reparaturkosten.
section - Immer "Used".
description - Beschreibung des Verkäufers. Lose von IAAI haben keine, deshalb ist das Feld immer null.
created_at - Zeitpunkt, zu dem das Los in unsere Datenbank gelangt ist.
offer_created - Zeitpunkt der Einstellung, wie IAAI ihn angibt. IAAI aktualisiert ihn, z. B. wenn ein Los erneut eingestellt oder die Auktion verschoben wird, daher kann er später als created_at liegen.
Fahrzeug
mark, model - Marke und Modell, wie IAAI sie schreibt: "CHEVROLET", "TAHOE".
complectation - Ausstattungslinie, z. B. "2WD LT".
year - Modelljahr.
first_registration - Erstzulassung. IAAI veröffentlicht sie nicht, deshalb ist das Feld immer null.
vin - VIN, wie IAAI sie anzeigt: die ersten 11 Zeichen, der Rest ist durch Sternchen verdeckt.
km_age - Laufleistung in km. Gibt IAAI statt der Laufleistung 0 oder 1 an (der Tacho ist nicht ablesbar, funktioniert nicht oder die Laufleistung ist von der Angabepflicht befreit), ist der Wert null.
odometer, odometer_unit - Tachostand wie auf IAAI und seine Einheit: "mi" (Meilen) oder "km".
odometer_status - Status des Tachostands, z. B. "Actual", "Not actual", "Exceeds mechanical limits" oder "Exempt" (ältere Fahrzeuge sind von der Angabepflicht für die Laufleistung befreit).
owners_count - Anzahl der Besitzer. IAAI veröffentlicht diese Angabe nicht, deshalb ist das Feld immer null.
vehicle_type - Fahrzeugtyp nach der Einteilung von IAAI, z. B. "Automobile", "Light truck" oder "Classic car". Die Karosserieform steht in body_type.
country_of_origin - Montageland.
Technische Daten
engine_type - Kraftstoff: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" oder "Other".
transmission_type - "Automatic", "Manual" oder "CVT".
body_type - Karosserieform, z. B. "SUV" oder "Pickup". Die Karosseriebezeichnung, wie IAAI sie schreibt, steht in original.body_type.
drive_type - Antrieb: "FWD", "RWD", "AWD" oder "4WD". "4x2" bedeutet, dass IAAI nicht angegeben hat, welche Achse angetrieben wird.
color, interior_color - Karosseriefarbe und Farbe des Innenraums.
displacement, displacement_cc - Hubraum in Litern, wie IAAI ihn angibt, und derselbe Wert in cm³ (5,3 l sind 5300).
engine - Motor, wie IAAI ihn beschreibt, z. B. "5.3L V-8 DI, VVT, 355HP".
cylinders - Anzahl der Zylinder.
power - Leistung in PS. Bei Hybriden und Elektroautos null: Die Systemleistung veröffentlicht IAAI nicht.
power_ice_hp - Leistung des Verbrennungsmotors in PS. Bei Hybriden ausgefüllt, auch wenn power null ist.
power_electro_kw, seat_count - Leistung des Elektromotors und Anzahl der Sitzplätze. IAAI veröffentlicht diese Angaben nicht, deshalb sind die Felder immer null.
Schäden und Eigentumsnachweis
primary_damage, secondary_damage - Haupt- und Nebenschaden, z. B. "Front end", "Left side", "Flood" oder "Hail".
loss_type - Warum das Fahrzeug in die Auktion kam: "Collision", "Theft", "Flood", "Fire" oder "Other".
condition - Startstatus: "Run & drive", "Starts", "Stationary" oder "Can't test".
has_keys - Ob Fahrzeugschlüssel vorhanden sind (true/false).
airbags - Zustand der Airbags, z. B. "Intact", "Deployed" oder "Missing".
restraint_system - Welche Airbags und Sicherheitsgurte das Fahrzeug hat.
catalytic_converter - Katalysator vorhanden (true) oder ausgebaut (false).
title_group - Art des Eigentumsnachweises (Title): "Clear", "Salvage", "Non-repairable" und andere. Bei kanadischen Losen kommt sie so, wie IAAI sie schreibt, z. B. "ON-NOT BRANDED-ONTARIO". null, solange der Eigentumsnachweis nicht bei IAAI eingegangen ist.
title_state - Wo der Eigentumsnachweis ausgestellt wurde: Bundesstaat oder Provinz.
title_brand, title_notes - Vermerk im Eigentumsnachweis (Title Brand) und Anmerkungen dazu, wie IAAI sie schreibt, z. B. "PREVIOUS SALVAGE".
declarations - Erklärungen des Verkäufers bei kanadischen Losen, Text wie bei IAAI, z. B. "TKU" (tatsächliche Kilometer unbekannt) oder ein Hinweis auf den CARFAX-Bericht.
Auktion, Verkäufer und Standort
auction_at - Beginn der Live-Auktion. null, solange IAAI keinen Termin festgelegt hat. Das Festlegen oder Verschieben des Auktionstermins erzeugt kein Ereignis in /changes. /offer und /offers liefern den aktuell geplanten Auktionstermin mit Uhrzeit.
auction_type - "Live auction" oder "Timed auction".
timed_auction_close_at - Ende der Zeitauktion.
branch, branch_id - Niederlassung von IAAI, in der das Los verkauft wird, und die Nummer der Niederlassung.
lane, run_number - Auktionsbahn (Lane) und Laufnummer des Loses darauf. IAAI vergibt beide kurz vor der Auktion, bis dahin null. Wie der Auktionstermin kommen sie nicht als eigene Ereignisse in /changes.
is_public - true, wenn das Los Privatkäufern offensteht (Vermerk Public). Wer das Los sonst noch kaufen darf, steht in who_can_buy.
who_can_buy - Wer das Los kaufen darf: "Dealers", "Dismantlers", "Exporters", "Public" und andere. IAAI füllt die Liste näher am Auktionstermin aus, bis dahin null.
seller_category - Woher das Fahrzeug in die Auktion kam: "Insurance company", "Remarketing", "Lease and rental", "Repossession" und andere.
seller_type, is_dealer, salon_id - Verkäufer. IAAI zeigt ihn nicht an, deshalb sind diese Felder immer null.
country - "USA" oder "Canada".
region, city - Bundesstaat oder Provinz und Stadt, in der das Fahrzeug steht.
address, zip - Adresse und Postleitzahl desselben Standorts.
latitude, longitude - Koordinaten desselben Standorts. Bei kanadischen Losen null.
Fotos, Videos und Referenzdaten
photos - Links zu Fotos in voller Größe. Bei einem Los ohne Fotos ein leeres Array.
photo_360_url - Link zur 360-Grad-Ansicht auf der Website von IAAI.
engine_video_url - Link zum Video des laufenden Motors.
options - Ausstattung, wie IAAI sie aufführt, in einer Gruppe "Equipment".
original - Originalwerte der wichtigsten Felder von iaai.com, ohne Übersetzung.
catalog_ids - Katalogcodes. IAAI veröffentlicht sie nicht, deshalb sind die Werte immer null.
GET/change_id
Erste Änderungs-ID nach Datum abrufen (für Verwendung in /changes)
Parameter:
date(erforderlich) - Datum im Format yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10Antwort:
{
"change_id": 208400
}Verwenden Sie den zurückgegebenen Wert als change_id-Parameter in /changes
GET/changes
Änderungs-Feed (hinzugefügt/geändert/entfernt)
Parameter:
change_id(erforderlich) - ab welcher Änderungs-ID
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412Antwort:
{
"result": [
{
"id": 208412,
"inner_id": "46237543~US",
"change_type": "changed",
"created_at": "2026-11-10T03:12:40Z",
"data": { // neuer Buy Now-Preis in der Währung des Loses (null, wenn Buy Now entfernt wurde)
"new_price": 28225
}
},
{
"id": 208413,
"inner_id": "47020463~US",
"change_type": "added",
"created_at": "2026-11-10T03:12:41Z",
"data": { ... } // vollständige Daten des Loses wie in /offers
},
{
"id": 208414,
"inner_id": "46769371~US",
"change_type": "removed",
"created_at": "2026-11-10T03:12:43Z",
"data": {} // Los aus dem Verkauf genommen
}
// ... danach die übrigen Ereignisse, bis zu 20 pro Seite
],
"meta": {
"cur_change_id": 208412,
"next_change_id": 208432,
"limit": 20
}
}GET/offer
Ein einzelnes Los per inner_id.
Parameter:
inner_id(erforderlich)
https://{access_name}.auto-api.com/api/v3/iaai/offer?api_key=YOUR_API_KEY&inner_id=43963919~USDie Antwort enthält nur das Objekt data, ohne umschließendes result.
Fehler
Bei einem Fehler enthält die Antwort das Feld error mit einer Beschreibung: { "error": "parameter page is required" }
401- der api_key wurde nicht akzeptiert400- ein erforderlicher Parameter fehlt oder ein Wert hat das falsche Format404- kein Los mit dieser inner_id (/offer)429- das Anfragelimit ist ausgeschöpft
Aufbewahrung
Dateien bleiben mindestens 3 Tage verfügbar
Verfügbarkeit
Jeden Morgen neue Dateien
CSV-Format
Die CSV-Spalten sind durch das Pipe-Zeichen (|) getrennt
URL-Struktur:
Parameter:
access_name- Ihre persönliche Subdomaindate- Exportdatum im Format jjjj-mm-tt, z. B. 2026-11-10file_name- Dateiname mit Erweiterung
Verfügbare Dateien:
- 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
Beispiel für eine cURL-Anfrage
curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
-H 'Authorization: Basic XXX' \
-o daily_car_data.csvBeispiel für einen Wget-Befehl
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'IAAI (iaai.com) ist die Website von Insurance Auto Auctions (IAA). Seit 2023 gehört das Unternehmen zu RB Global. Eingeliefert werden die Fahrzeuge in den USA und Kanada von Versicherungsgesellschaften nach Unfall, Überschwemmung, Brand oder Diebstahl sowie von Banken, Händlern, Leasinggesellschaften und Autovermietungen.
Verkauft wird ein Los in einer Live-Auktion an einem festgelegten Tag oder in einer Zeitauktion, und einen Teil der Lose kann man schon vor der Auktion zum Buy Now-Preis kaufen. Manche Lose werden nur an Käufer mit Lizenz verkauft, etwa an Händler, Autoverwerter und Exporteure, während Lose mit dem Vermerk Public auch Privatkäufern offenstehen. Gebote und Verkaufspreise veröffentlicht IAAI nicht.
Importeure sehen im Los, ob Exporteure es kaufen dürfen. Aus Modelljahr, Hubraum und Motorleistung lässt sich der Einfuhrzoll abschätzen, und mit den ersten 11 Zeichen der VIN prüfen Sie Modell und Werk.
Über /changes erhalten Sie neue Lose, neue Buy Now-Preise und aus dem Verkauf genommene Lose. Wird ein Los aus dem Verkauf genommen, heißt das nicht immer, dass es verkauft wurde.
Erweitern Sie Ihre Fahrzeugdaten-Abdeckung auf globalen Märkten mit unseren umfassenden Plattform-APIs: