AUTO-API.COM
Logo IAAI

IAAI APIScraper et parser

IAAI API : lots d'enchères d'assurance USA et Canada, Buy Now, ACV, estimation des réparations, dommages, titre de propriété, date de vente. Flux et fichiers.

Bibliothèques SDK officielles

Nos SDK proposent les méthodes de l'API sous forme de fonctions prêtes à l'emploi, et le code des bibliothèques est open source sur GitHub.

IAAI API

Le parser collecte les lots d'IAAI, les enchères automobiles d'assurance des États-Unis et du Canada, parmi lesquels des voitures, des SUV, des pick-up et des fourgons. Avec l'API, vous pouvez filtrer les lots selon les critères d'un acheteur et les suivre dans le flux de changements jusqu'à leur retrait de la vente. Vous n'avez pas besoin d'écrire ni de maintenir votre propre scraper pour iaai.com.

API

Le flux /changes renvoie les événements des lots IAAI : nouveau lot, nouveau prix Buy Now, retrait de la vente.

Exports quotidiens

L'export quotidien regroupe les lots IAAI en vente à la date de l'export.

Données complètes

Kilométrage et statut du compteur, moteur et puissance, dommages, motif de la mise en vente, type de titre de propriété, clés du véhicule et airbags, date de vente et agence, acheteurs autorisés, photos et vidéo du moteur.

Obtenir un accès APIAccès accordé sous 2 minutes

Un lot a deux numéros : inner_id, qui sert à demander le lot à /offer, et stock_number, le numéro sous lequel les acheteurs le connaissent aux enchères IAAI.

URL de base

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

Autorisation : api_key paramètre

Flux de travail

1
/filtersobtenir les valeurs de filtre disponibles
2

Premier chargement :

/change_id?date=...obtenir l'ID de départ pour le flux de changements
/offersobtenir tous les lots page par page
3
/changes?change_id=...obtenir tous les changements dans la base de données à partir de l'ID
4
/offerun lot par inner_id

Par où commencer :

1. Avant le premier chargement, prenez le numéro renvoyé par /change_id pour la date du jour et conservez-le. Puis parcourez /offers page par page jusqu'au bout : sur la dernière page, next_page vaut null.

2. Ensuite, interrogez /changes à partir de ce numéro en transmettant le next_change_id de chaque réponse. C'est ainsi qu'arrivent les nouveaux lots, les nouveaux prix Buy Now et les lots retirés de la vente. Si next_change_id vaut null, il n'y a pas encore d'événement : relancez la même requête plus tard.

3. Pour chercher selon vos propres critères, appelez /offers avec des filtres.

Format des données

  • Les types sont conservés : un nombre reste un nombre, une liste devient un tableau, une valeur absente vaut null.
  • Les horodatages sont en UTC, par exemple "2026-11-12T14:30:00Z".
  • Le prix, l'ACV et l'estimation des réparations sont exprimés dans la devise du lot : USD pour les lots des États-Unis, CAD pour les lots canadiens.
  • Tous les lots ont le même ensemble de champs. Une valeur absente vaut null, par exemple auction_at tant qu'IAAI n'a pas fixé la date de vente. photos fait exception : pour un lot sans photo, c'est un tableau vide.

GET/filters

Retourne toutes les valeurs possibles pour le filtrage

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

Réponse :

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

Lots page par page. Les filtres permettent de restreindre les résultats.

Paramètres :

  • page (requis) - numéro de page
  • mark, model - marque et modèle comme dans /filters, sans distinction de casse
  • transmission_type, color, body_type, engine_type, drive_type - boîte de vitesses, couleur, carrosserie, carburant et roues motrices, avec les valeurs de /filters, sans distinction de casse
  • year_from, year_to - année-modèle minimale et maximale
  • km_age_from, km_age_to - kilométrage minimal et maximal, en km
  • price_from, price_to - prix Buy Now minimal et maximal, dans la devise du lot. Les lots sans Buy Now ne correspondent pas à ces filtres

Pour transmettre plusieurs valeurs à un filtre, répétez le paramètre avec des crochets : 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

Réponse :

{
  "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": {  // valeurs d'origine telles que sur 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"]
        }
      }
    }
    // ... puis les autres lots, jusqu'à 20 par page
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Champs de données :

Lot

id - ID interne de base de données

inner_id - Identifiant du lot tiré du lien IAAI, avec le marché après le tilde : "43963919~US", ou de la forme "Imp_3139055~CA" pour les lots canadiens. C'est cet identifiant qu'accepte /offer.

stock_number - Stock#, le numéro du lot qu'IAAI affiche sur son site et aux enchères.

url - Lien vers le lot.

price, currency - Prix Buy Now et devise, USD ou CAD. Si le lot n'a pas de prix Buy Now, price vaut null.

acv - ACV, valeur estimée du véhicule avant les dommages.

repair_cost - Coût estimé des réparations.

section - Toujours "Used".

description - Description du vendeur. Les lots IAAI n'en ont pas, elle vaut donc toujours null.

created_at - Date et heure d'arrivée du lot dans notre base.

offer_created - Date et heure de mise en vente, telles qu'IAAI les indique. IAAI les met à jour, par exemple quand un lot est remis en vente ou que la vente est reportée, si bien qu'elles peuvent être postérieures à created_at.

Véhicule

mark, model - Marque et modèle tels qu'IAAI les écrit : "CHEVROLET", "TAHOE".

complectation - Finition, par exemple "2WD LT".

year - Année-modèle.

first_registration - Première immatriculation. IAAI ne la publie pas, elle vaut donc toujours null.

vin - VIN tel qu'IAAI l'affiche : les 11 premiers caractères, le reste étant masqué par des astérisques.

km_age - Kilométrage en km. Si IAAI indique 0 ou 1 au lieu du kilométrage (le compteur est illisible ou ne fonctionne pas, ou le kilométrage est exempté de déclaration), le champ vaut null.

odometer, odometer_unit - Relevé du compteur tel qu'affiché sur IAAI, et son unité : "mi" (miles) ou "km".

odometer_status - Statut du compteur, par exemple "Actual", "Not actual", "Exceeds mechanical limits" ou "Exempt" (les véhicules anciens sont exemptés de déclaration du kilométrage).

owners_count - Nombre de propriétaires. IAAI ne publie pas ce nombre, il vaut donc toujours null.

vehicle_type - Type de véhicule selon la classification IAAI, par exemple "Automobile", "Light truck" ou "Classic car". Le type de carrosserie arrive dans body_type.

country_of_origin - Pays d'assemblage.

Caractéristiques techniques

engine_type - Carburant : "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" ou "Other".

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

body_type - Type de carrosserie, par exemple "SUV" ou "Pickup". La désignation de carrosserie telle qu'IAAI l'écrit se trouve dans original.body_type.

drive_type - Roues motrices : "FWD", "RWD", "AWD" ou "4WD". "4x2" signifie qu'IAAI n'a pas précisé quel essieu est moteur.

color, interior_color - Couleur de la carrosserie et couleur de l'habitacle.

displacement, displacement_cc - Cylindrée en litres telle qu'IAAI l'indique, et la même valeur en cm³ (5,3 l correspondent à 5300).

engine - Moteur tel qu'IAAI le décrit, par exemple "5.3L V-8 DI, VVT, 355HP".

cylinders - Nombre de cylindres.

power - Puissance en ch. Vaut null pour les hybrides et les voitures électriques : IAAI ne publie pas la puissance totale du système.

power_ice_hp - Puissance du moteur thermique en ch. Renseignée pour les hybrides, même quand power vaut null.

power_electro_kw, seat_count - Puissance du moteur électrique et nombre de places. IAAI ne les publie pas, ils valent donc toujours null.

Dommages et titre de propriété

primary_damage, secondary_damage - Dommage principal et dommage secondaire, par exemple "Front end", "Left side", "Flood" ou "Hail".

loss_type - Raison pour laquelle le véhicule a été mis aux enchères : "Collision", "Theft", "Flood", "Fire" ou "Other".

condition - État de démarrage : "Run & drive", "Starts", "Stationary" ou "Can't test".

has_keys - Présence des clés du véhicule (true/false).

airbags - État des airbags, par exemple "Intact", "Deployed" ou "Missing".

restraint_system - Airbags et ceintures de sécurité dont le véhicule est équipé.

catalytic_converter - Pot catalytique en place (true) ou retiré (false).

title_group - Type de titre de propriété : "Clear", "Salvage", "Non-repairable" et autres. Pour les lots canadiens, il arrive tel qu'IAAI l'écrit, par exemple "ON-NOT BRANDED-ONTARIO". Vaut null tant que le titre de propriété n'est pas parvenu à IAAI.

title_state - État ou province qui a délivré le titre de propriété.

title_brand, title_notes - Mention et remarques portées sur le titre de propriété, telles qu'IAAI les écrit, par exemple "PREVIOUS SALVAGE".

declarations - Déclarations du vendeur pour les lots canadiens, texte tel qu'IAAI l'écrit, par exemple "TKU" (kilométrage réel inconnu) ou un renvoi au rapport CARFAX.

Vente, vendeur et emplacement

auction_at - Début des enchères en direct. Vaut null tant qu'IAAI n'a pas fixé la date. La fixation ou le report de la date de vente ne crée pas d'événement dans /changes. /offer et /offers renvoient la date et l'heure de vente actuellement prévues.

auction_type - "Live auction" ou "Timed auction".

timed_auction_close_at - Fin des enchères à durée limitée.

branch, branch_id - Agence IAAI où le lot est vendu, et numéro de l'agence.

lane, run_number - Voie de vente (lane) et numéro de passage du lot dans cette voie. IAAI les attribue peu avant la vente ; jusque-là, ils valent null. Comme la date de vente, ils n'arrivent pas sous forme d'événements distincts dans /changes.

is_public - true si le lot est ouvert aux particuliers (mention Public). Les autres catégories d'acheteurs autorisées figurent dans who_can_buy.

who_can_buy - Qui peut acheter le lot : "Dealers", "Dismantlers", "Exporters", "Public" et autres. IAAI remplit la liste à l'approche de la vente ; jusque-là, le champ vaut null.

seller_category - Origine du véhicule mis aux enchères : "Insurance company", "Remarketing", "Lease and rental", "Repossession" et autres.

seller_type, is_dealer, salon_id - Vendeur. IAAI ne l'affiche pas, ces champs valent donc toujours null.

country - "USA" ou "Canada".

region, city - État ou province et ville où se trouve le véhicule.

address, zip - Adresse et code ZIP ou code postal de ce même lieu.

latitude, longitude - Coordonnées GPS de ce même lieu. Valent null pour les lots canadiens.

Photos, vidéos et données de référence

photos - Liens vers les photos en taille d'origine. Tableau vide pour un lot sans photo.

photo_360_url - Lien vers la vue à 360° sur le site IAAI.

engine_video_url - Lien vers la vidéo du moteur en marche.

options - Équipements tels qu'IAAI les liste, dans un seul groupe "Equipment".

original - Valeurs d'origine des principaux champs, telles que sur iaai.com, sans traduction.

catalog_ids - Codes de catalogue. IAAI ne les publie pas, les valeurs sont donc toujours null.

GET/change_id

Obtenir le premier ID de changement par date (pour utiliser dans /changes)

Paramètres :

  • date (requis) - date au format yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10

Réponse :

{
  "change_id": 208400
}

Utilisez la valeur retournée comme paramètre change_id dans /changes

GET/changes

Flux de changements (ajouté/modifié/supprimé)

Paramètres :

  • change_id (requis) - à partir de quel ID de changement
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412

Réponse :

{
  "result": [
    {
      "id": 208412,
      "inner_id": "46237543~US",
      "change_type": "changed",
      "created_at": "2026-11-10T03:12:40Z",
      "data": {  // nouveau prix Buy Now dans la devise du lot (null si le Buy Now a été retiré)
        "new_price": 28225
      }
    },
    {
      "id": 208413,
      "inner_id": "47020463~US",
      "change_type": "added",
      "created_at": "2026-11-10T03:12:41Z",
      "data": { ... }  // contenu complet du lot, comme dans /offers
    },
    {
      "id": 208414,
      "inner_id": "46769371~US",
      "change_type": "removed",
      "created_at": "2026-11-10T03:12:43Z",
      "data": {}  // lot retiré de la vente
    }
    // ... puis les autres événements, jusqu'à 20 par page
  ],
  "meta": {
    "cur_change_id": 208412,
    "next_change_id": 208432,
    "limit": 20
  }
}

GET/offer

Un lot par inner_id.

Paramètres :

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

La réponse contient uniquement l'objet data, sans l'enveloppe result.

Erreurs

En cas d'erreur, la réponse contient un champ error avec une description : { "error": "parameter page is required" }

  • 401 - la clé api_key n'a pas été acceptée
  • 400 - un paramètre obligatoire manque ou une valeur n'a pas le bon format
  • 404 - aucun lot avec cet inner_id (/offer)
  • 429 - la limite de requêtes est atteinte

Conservation

Les fichiers restent disponibles au moins 3 jours

Disponibilité

De nouveaux fichiers chaque matin

Format CSV

Les colonnes CSV sont séparées par le caractère pipe (|)

Structure de l'URL :

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

Paramètres :

  • access_name - votre sous-domaine personnel
  • date - date de l'export au format aaaa-mm-jj, par ex. 2026-11-10
  • file_name - nom du fichier avec extension

Fichiers disponibles :

  • 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

Exemple de requête 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

Exemple de commande Wget

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

IAAI (iaai.com) est le site d'Insurance Auto Auctions (IAA). Depuis 2023, l'entreprise fait partie de RB Global. Aux États-Unis et au Canada, les véhicules sont mis aux enchères par des compagnies d'assurance après une collision, une inondation, un incendie ou un vol, ainsi que par des banques, des concessionnaires, des sociétés de leasing et de location.

Un lot est vendu lors d'enchères en direct à une date fixée ou lors d'enchères à durée limitée, et une partie des lots peut être achetée avant les enchères au prix Buy Now. Certains lots ne sont vendus qu'à des acheteurs titulaires d'une licence, comme les concessionnaires, les démolisseurs et les exportateurs, tandis que les lots portant la mention Public sont aussi ouverts aux particuliers. IAAI ne publie ni les montants des enchères ni les prix de vente.

Un importateur voit dans le lot si les exportateurs sont autorisés à l'acheter. L'année-modèle, la cylindrée et la puissance du moteur permettent d'estimer les droits de douane, et les 11 premiers caractères du VIN de vérifier le modèle et l'usine.

Les nouveaux lots, les nouveaux prix Buy Now et les retraits de la vente arrivent via /changes. Un retrait de la vente ne signifie pas toujours que le lot a été vendu.

Réponse en moins de 2 min