
IAAI APIScraper y parser
IAAI API: lotes de aseguradoras de EE. UU. y Canadá con Buy Now, ACV, coste de reparación, daños, tipo de título y fecha de subasta. Feed de cambios y archivos.
IAAI API
El parser recopila los lotes de turismos, SUV, pick-ups y furgonetas de IAAI, las subastas de coches de aseguradoras de EE. UU. y Canadá. Con la API puede seleccionar con filtros los lotes que se ajustan a lo que pide el comprador y seguirlos en el feed de cambios hasta que se retiren de la venta. No hace falta escribir ni mantener un scraper propio para iaai.com.
El feed /changes devuelve eventos de los lotes de IAAI: lote nuevo, nuevo precio Buy Now y retirada de la venta.
La exportación diaria reúne los lotes de IAAI que están en venta en la fecha de la exportación.
Kilometraje y estado del odómetro, motor y potencia, daños, motivo de la venta, tipo de título de propiedad, llaves y airbags, fecha de la subasta y sucursal, compradores admitidos, fotos y vídeo del motor.
Un lote tiene dos números: inner_id, con el que se pide el lote a /offer, y stock_number, el número con el que lo conocen los compradores en las subastas de IAAI.
URL base
https://{access_name}.auto-api.com/api/v3/iaaiAutorización: api_key parámetro
Flujo de trabajo
/filtersobtener valores de filtro disponiblesCarga inicial:
/change_id?date=...obtener ID inicial para el feed de cambios/offersobtener todos los lotes página a página/changes?change_id=...obtener todos los cambios en la base de datos desde el ID/offerun lote por inner_idPor dónde empezar:
1. Antes de la primera carga, obtenga el número de /change_id para la fecha de hoy y guárdelo. Después recorra /offers página a página hasta el final: en la última página next_page vale null.
2. Luego consulte /changes desde ese número y pase cada vez next_change_id de la respuesta. Así llegan los lotes nuevos, los nuevos precios Buy Now y las retiradas de lotes de la venta. Si next_change_id vale null, todavía no hay eventos: repita la misma petición más tarde.
3. Para buscar según sus propios criterios, llame a /offers con filtros.
Formato de los datos
- Los tipos se conservan: un número llega como número, una lista como array y un valor ausente como null.
- Las marcas de tiempo están en UTC, por ejemplo "2026-11-12T14:30:00Z".
- El precio, el ACV y el coste estimado de reparación están en la moneda del lote: USD en los lotes de EE. UU. y CAD en los de Canadá.
- Todos los lotes tienen el mismo conjunto de campos. Si falta un valor, llega null, por ejemplo en auction_at mientras IAAI no fije la fecha de la subasta. La excepción es photos: en un lote sin fotos llega un array vacío.
GET/filters
Devuelve todos los valores posibles para filtrado
https://{access_name}.auto-api.com/api/v3/iaai/filters?api_key=YOUR_API_KEYRespuesta:
{
"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
Lotes página a página. Los filtros acotan los resultados.
Parámetros:
page(requerido) - número de páginamark, model- marca y modelo tal como se escriben en /filters, sin distinguir mayúsculastransmission_type, color, body_type, engine_type, drive_type- caja de cambios, color, carrocería, combustible y tracción, con los valores de /filters, sin distinguir mayúsculasyear_from, year_to- año del modelo, desde y hastakm_age_from, km_age_to- kilometraje en km, desde y hastaprice_from, price_to- precio Buy Now, desde y hasta, en la moneda del lote. Los lotes sin Buy Now no aparecen con estos filtros
Para pasar varios valores a un filtro, repita el parámetro con corchetes: 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=15000Respuesta:
{
"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": { // valores originales de 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"]
}
}
}
// ... después, el resto de lotes, hasta 20 por página
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Campos de datos:
Lote
id - ID interno de base de datos
inner_id - ID del lote tomado del enlace de IAAI, con el mercado tras el signo ~: "43963919~US", o del tipo "Imp_3139055~CA" en los lotes de Canadá. Este es el ID que acepta /offer.
stock_number - Stock#, el número del lote que IAAI muestra en su web y en la subasta.
url - Enlace al lote.
price, currency - Precio Buy Now y moneda, USD o CAD. Si el lote no tiene precio Buy Now, price vale null.
acv - ACV, el valor estimado del coche antes de los daños.
repair_cost - Coste estimado de la reparación.
section - Siempre "Used".
description - Descripción del vendedor. Los lotes de IAAI no la tienen, así que siempre vale null.
created_at - Fecha y hora en que el lote llegó a nuestra base de datos.
offer_created - Fecha y hora de publicación según IAAI. IAAI la actualiza, por ejemplo cuando el lote se vuelve a poner a la venta o la subasta cambia de fecha, así que puede ser posterior a created_at.
Coche
mark, model - Marca y modelo tal como los escribe IAAI: "CHEVROLET", "TAHOE".
complectation - Acabado, por ejemplo "2WD LT".
year - Año del modelo.
first_registration - Primera matriculación. IAAI no publica este dato, así que siempre vale null.
vin - VIN tal como lo muestra IAAI: los primeros 11 caracteres; el resto queda oculto con asteriscos.
km_age - Kilometraje en km. Si en lugar del kilometraje IAAI indica 0 o 1 (el odómetro no se puede leer o no funciona, o el kilometraje está exento de declaración), vale null.
odometer, odometer_unit - Lectura del odómetro tal como figura en IAAI y su unidad: "mi" (millas) o "km".
odometer_status - Estado del odómetro, por ejemplo "Actual", "Not actual", "Exceeds mechanical limits" o "Exempt" (los coches más antiguos están exentos de declarar el kilometraje).
owners_count - Número de propietarios. IAAI no publica este dato, así que siempre vale null.
vehicle_type - Tipo de vehículo según la clasificación de IAAI, por ejemplo "Automobile", "Light truck" o "Classic car". El tipo de carrocería llega en body_type.
country_of_origin - País de montaje.
Especificaciones
engine_type - Combustible: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" u "Other".
transmission_type - "Automatic", "Manual" o "CVT".
body_type - Tipo de carrocería, por ejemplo "SUV" o "Pickup". La carrocería tal como la escribe IAAI está en original.body_type.
drive_type - Tracción: "FWD", "RWD", "AWD" o "4WD". "4x2" significa que IAAI no indicó qué eje es el motriz.
color, interior_color - Color de la carrocería y color del interior.
displacement, displacement_cc - Cilindrada en litros tal como la da IAAI, y la misma en cc (5,3 l son 5300).
engine - Motor tal como lo describe IAAI, por ejemplo "5.3L V-8 DI, VVT, 355HP".
cylinders - Número de cilindros.
power - Potencia en hp. null en los híbridos y los eléctricos: IAAI no publica la potencia total del sistema.
power_ice_hp - Potencia del motor de combustión en hp. En los híbridos se rellena aunque power valga null.
power_electro_kw, seat_count - Potencia del motor eléctrico y número de plazas. IAAI no publica estos datos, así que siempre valen null.
Daños y título de propiedad
primary_damage, secondary_damage - Daño principal y daño secundario, por ejemplo "Front end", "Left side", "Flood" o "Hail".
loss_type - Por qué el coche salió a subasta: "Collision", "Theft", "Flood", "Fire" u "Other".
condition - Estado de arranque: "Run & drive", "Starts", "Stationary" o "Can't test".
has_keys - Si están las llaves del coche (true/false).
airbags - Estado de los airbags, por ejemplo "Intact", "Deployed" o "Missing".
restraint_system - Airbags y cinturones de seguridad que tiene el coche.
catalytic_converter - Catalizador en su sitio (true) o desmontado (false).
title_group - Tipo de título de propiedad: "Clear", "Salvage", "Non-repairable" y otros. En los lotes de Canadá llega tal como lo escribe IAAI, por ejemplo "ON-NOT BRANDED-ONTARIO". null mientras el título no haya llegado a IAAI.
title_state - Estado o provincia que emitió el título de propiedad.
title_brand, title_notes - Anotación y observaciones del título de propiedad tal como las escribe IAAI, por ejemplo "PREVIOUS SALVAGE".
declarations - Declaraciones del vendedor en los lotes de Canadá, con el texto tal como lo escribe IAAI, por ejemplo "TKU" (kilometraje real desconocido) o una referencia al informe CARFAX.
Venta, vendedor y ubicación
auction_at - Inicio de la subasta en vivo. null mientras IAAI no fije la fecha. Fijar o cambiar la fecha de la subasta no genera ningún evento en /changes. /offer y /offers devuelven la fecha y la hora de la subasta actualizadas.
auction_type - "Live auction" o "Timed auction".
timed_auction_close_at - Cierre de la subasta temporizada.
branch, branch_id - Sucursal de IAAI donde se vende el lote y número de la sucursal.
lane, run_number - Carril de la subasta y número de orden del lote en ese carril. IAAI los asigna poco antes de la subasta; hasta entonces, null. Igual que la fecha de la subasta, no llegan como eventos propios en /changes.
is_public - true si el lote está abierto a compradores particulares (etiqueta Public). Quién más puede comprar el lote figura en who_can_buy.
who_can_buy - Quién puede comprar el lote: "Dealers", "Dismantlers", "Exporters", "Public" y otros. IAAI rellena la lista cuando se acerca la subasta; hasta entonces, null.
seller_category - De dónde llegó el coche a la subasta: "Insurance company", "Remarketing", "Lease and rental", "Repossession" y otros.
seller_type, is_dealer, salon_id - Vendedor. IAAI no lo muestra, así que estos campos siempre valen null.
country - "USA" o "Canada".
region, city - Estado o provincia y ciudad donde está el coche.
address, zip - Dirección y código ZIP o código postal de ese mismo lugar.
latitude, longitude - Coordenadas de ese mismo lugar. null en los lotes de Canadá.
Fotos, vídeos y datos de referencia
photos - Enlaces a las fotos en tamaño completo. Un array vacío si el lote no tiene fotos.
photo_360_url - Enlace a la vista 360 en la web de IAAI.
engine_video_url - Enlace al vídeo del motor en marcha.
options - Equipamiento tal como lo enumera IAAI, en un único grupo "Equipment".
original - Valores originales de los campos principales de iaai.com, sin traducir.
catalog_ids - Códigos de catálogo. IAAI no los publica, así que los valores siempre son null.
GET/change_id
Obtener primer ID de cambio por fecha (para usar en /changes)
Parámetros:
date(requerido) - fecha en formato yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10Respuesta:
{
"change_id": 208400
}Use el valor devuelto como parámetro change_id en /changes
GET/changes
Feed de cambios (añadido/cambiado/eliminado)
Parámetros:
change_id(requerido) - a partir de qué ID de cambio
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412Respuesta:
{
"result": [
{
"id": 208412,
"inner_id": "46237543~US",
"change_type": "changed",
"created_at": "2026-11-10T03:12:40Z",
"data": { // nuevo precio Buy Now en la moneda del lote (null si el lote ya no tiene Buy Now)
"new_price": 28225
}
},
{
"id": 208413,
"inner_id": "47020463~US",
"change_type": "added",
"created_at": "2026-11-10T03:12:41Z",
"data": { ... } // el lote completo, como en /offers
},
{
"id": 208414,
"inner_id": "46769371~US",
"change_type": "removed",
"created_at": "2026-11-10T03:12:43Z",
"data": {} // lote retirado de la venta
}
// ... después, el resto de eventos, hasta 20 por página
],
"meta": {
"cur_change_id": 208412,
"next_change_id": 208432,
"limit": 20
}
}GET/offer
Un lote por inner_id.
Parámetros:
inner_id(requerido)
https://{access_name}.auto-api.com/api/v3/iaai/offer?api_key=YOUR_API_KEY&inner_id=43963919~USLa respuesta contiene solo el objeto data, sin el envoltorio result.
Errores
Si hay un error, la respuesta incluye el campo error con su descripción: { "error": "parameter page is required" }
401- no se aceptó la clave api_key400- falta un parámetro obligatorio o un valor tiene un formato incorrecto404- no hay ningún lote con ese inner_id (/offer)429- se ha agotado el límite de peticiones
Retención
Los archivos siguen disponibles al menos 3 días
Disponibilidad
Archivos nuevos cada mañana
Formato CSV
Las columnas del CSV se separan con el carácter pipe (|)
Estructura de la URL:
Parámetros:
access_name- su subdominio personaldate- fecha de la exportación en formato aaaa-mm-dd, p. ej. 2026-11-10file_name- nombre del archivo con extensión
Archivos 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
Ejemplo de petición 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.csvEjemplo de comando Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'IAAI (iaai.com) es el sitio web de Insurance Auto Auctions (IAA). Desde 2023 la empresa forma parte de RB Global. Los coches que salen a subasta en EE. UU. y Canadá llegan de las aseguradoras, tras un accidente, una inundación, un incendio o un robo, y también de bancos, concesionarios y empresas de leasing y de alquiler.
El lote se vende en una subasta en vivo el día fijado o en una subasta temporizada, y algunos lotes se pueden comprar antes de la subasta por su precio Buy Now. Ciertos lotes se venden solo a compradores con licencia, como concesionarios, desguaces y exportadores, mientras que los lotes con la etiqueta Public están abiertos también a compradores particulares. IAAI no publica las pujas ni los precios de venta.
Un importador ve en el lote si los exportadores pueden comprarlo. Con el año del modelo, la cilindrada y la potencia del motor se pueden estimar los aranceles de importación, y con los primeros 11 caracteres del VIN, comprobar el modelo y la fábrica.
A través de /changes llegan los lotes nuevos, los nuevos precios Buy Now y las retiradas de la venta. Que un lote se retire de la venta no siempre significa que se haya vendido.
Expanda su cobertura de datos automotrices en mercados globales con nuestras APIs de plataforma: