AUTO-API.COM
Logotipo de IAAI

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.

Bibliotecas SDK oficiales

Nuestros SDK incluyen los métodos de la API como funciones listas para usar. Las bibliotecas son de código abierto y están en GitHub.

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.

API

El feed /changes devuelve eventos de los lotes de IAAI: lote nuevo, nuevo precio Buy Now y retirada de la venta.

Exportaciones diarias

La exportación diaria reúne los lotes de IAAI que están en venta en la fecha de la exportación.

Datos completos

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.

Obtener acceso a la APIAcceso proporcionado en 2 minutos

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

Autorización: api_key parámetro

Flujo de trabajo

1
/filtersobtener valores de filtro disponibles
2

Carga inicial:

/change_id?date=...obtener ID inicial para el feed de cambios
/offersobtener todos los lotes página a página
3
/changes?change_id=...obtener todos los cambios en la base de datos desde el ID
4
/offerun lote por inner_id

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

Respuesta:

{
  "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ágina
  • mark, model - marca y modelo tal como se escriben en /filters, sin distinguir mayúsculas
  • transmission_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úsculas
  • year_from, year_to - año del modelo, desde y hasta
  • km_age_from, km_age_to - kilometraje en km, desde y hasta
  • price_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=15000

Respuesta:

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

Respuesta:

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

Respuesta:

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

La 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_key
  • 400 - falta un parámetro obligatorio o un valor tiene un formato incorrecto
  • 404 - 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:

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

Parámetros:

  • access_name - su subdominio personal
  • date - fecha de la exportación en formato aaaa-mm-dd, p. ej. 2026-11-10
  • file_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.csv

Ejemplo de comando Wget

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

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.

Respuesta en 2 min