AUTO-API.COM
Logótipo IAAI

IAAI APIScraper e parser

IAAI API: lotes de leilões de seguradoras dos EUA e Canadá com Buy Now, ACV, custo de reparação, danos, título e data do leilão. Feed de alterações e ficheiros.

Bibliotecas SDK oficiais

Os nossos SDKs trazem os métodos da API como funções prontas a usar, e o código das bibliotecas é aberto e está no GitHub.

IAAI API

O parser recolhe os lotes da IAAI, os leilões automóveis de seguradoras dos EUA e do Canadá, incluindo automóveis ligeiros, SUV, pick-ups e carrinhas. Com a API pode filtrar os lotes de acordo com os requisitos de um comprador e acompanhar esses lotes pelo feed de alterações até serem retirados de venda. Não precisa de escrever nem de manter um scraper próprio de iaai.com.

API

O feed /changes devolve eventos dos lotes da IAAI: novo lote, novo preço Buy Now, retirada de venda.

Exportações diárias

A exportação diária reúne os lotes da IAAI que estão à venda na data da exportação.

Dados completos

Quilometragem e estado do conta-quilómetros, motor e potência, danos, motivo da venda, tipo de título de propriedade, chaves e airbags, data do leilão e filial, compradores autorizados, fotos e vídeo do motor.

Obter acesso à APIAcesso fornecido em 2 minutos

Um lote tem dois números: inner_id, usado para consultar o lote em /offer, e stock_number, o número pelo qual os compradores o conhecem nos leilões da IAAI.

URL Base

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

Autorização: api_key parâmetro

Fluxo de Trabalho

1
/filtersobter valores de filtro disponíveis
2

Carregamento inicial:

/change_id?date=...obter ID inicial para o feed de alterações
/offersobter todos os lotes, página por página
3
/changes?change_id=...obter todas as alterações no banco de dados a partir do ID
4
/offerum lote pelo inner_id

Por onde começar:

1. Antes do primeiro carregamento, pegue o número de /change_id para a data de hoje e guarde-o. Depois percorra /offers página por página até o fim: na última página, next_page é null.

2. Em seguida, consulte /changes a partir desse número, passando o next_change_id de cada resposta. É assim que chegam os novos lotes, os novos preços Buy Now e os lotes retirados de venda. Se next_change_id vier como null, ainda não há eventos: repita a mesma requisição mais tarde.

3. Para buscar pelos seus próprios critérios, chame /offers com filtros.

Formato dos dados

  • Os tipos são mantidos: um número vem como número, uma lista como array, um valor ausente como null.
  • Os valores de data e hora estão em UTC, por exemplo "2026-11-12T14:30:00Z".
  • O preço, o ACV e a estimativa de reparação estão na moeda do lote: USD nos lotes dos EUA, CAD nos lotes do Canadá.
  • Todos os lotes têm o mesmo conjunto de campos. Um valor ausente é null, por exemplo auction_at enquanto a IAAI não marcar a data do leilão. A exceção é photos: em um lote sem fotos, o valor é um array vazio.

GET/filters

Retorna todos os valores possíveis para filtragem

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

Resposta:

{
  "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 por página. Os filtros restringem os resultados.

Parâmetros:

  • page (obrigatório) - número da página
  • mark, model - marca e modelo como em /filters, sem diferenciar maiúsculas de minúsculas
  • transmission_type, color, body_type, engine_type, drive_type - transmissão, cor, carroceria, combustível e tração, com os valores de /filters, sem diferenciar maiúsculas de minúsculas
  • year_from, year_to - intervalo do ano-modelo
  • km_age_from, km_age_to - intervalo de quilometragem, em km
  • price_from, price_to - intervalo do preço Buy Now, na moeda do lote. Lotes sem Buy Now não aparecem com esses filtros

Para passar vários valores a um filtro, repita o parâmetro com colchetes: 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

Resposta:

{
  "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 originais do 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"]
        }
      }
    }
    // ... depois os demais lotes, até 20 por página
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Campos de dados:

Lote

id - ID interno do banco de dados

inner_id - ID do lote no link da IAAI, com o mercado depois do til: "43963919~US", ou no formato "Imp_3139055~CA" nos lotes do Canadá. É esse o ID que /offer aceita.

stock_number - Stock#, o número do lote que a IAAI mostra no site e no leilão.

url - Link para o lote.

price, currency - Preço Buy Now e moeda, USD ou CAD. Se o lote não tiver preço Buy Now, price é null.

acv - ACV, o valor estimado do carro antes do dano.

repair_cost - Custo estimado da reparação.

section - Sempre "Used".

description - Descrição do vendedor. Os lotes da IAAI não têm descrição, por isso o campo é sempre null.

created_at - Data e hora em que o lote entrou no nosso banco de dados.

offer_created - Data e hora de publicação do lote, conforme a IAAI informa. A IAAI atualiza esse valor, por exemplo quando o lote é colocado de novo à venda ou o leilão é remarcado, por isso ele pode ser posterior a created_at.

Carro

mark, model - Marca e modelo, como a IAAI os escreve: "CHEVROLET", "TAHOE".

complectation - Versão, por exemplo "2WD LT".

year - Ano-modelo.

first_registration - Primeiro registro. A IAAI não publica esse dado, por isso o campo é sempre null.

vin - VIN como a IAAI o mostra: os primeiros 11 caracteres, com o restante oculto por asteriscos.

km_age - Quilometragem em km. Se, em vez da quilometragem, a IAAI informar 0 ou 1 (o hodômetro não pode ser lido, não funciona ou a quilometragem é isenta de declaração), o campo é null.

odometer, odometer_unit - Leitura do hodômetro, como na IAAI, e a unidade de medida: "mi" (milhas) ou "km".

odometer_status - Estado da leitura do hodômetro, por exemplo "Actual", "Not actual", "Exceeds mechanical limits" ou "Exempt" (carros mais antigos são isentos da declaração de quilometragem).

owners_count - Número de proprietários. A IAAI não publica esse número, por isso o campo é sempre null.

vehicle_type - Tipo de veículo na classificação da IAAI, por exemplo "Automobile", "Light truck" ou "Classic car". O tipo de carroceria vem em body_type.

country_of_origin - País de montagem.

Especificações

engine_type - Combustível: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" ou "Other".

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

body_type - Tipo de carroceria, por exemplo "SUV" ou "Pickup". O nome da carroceria como a IAAI o escreve está em original.body_type.

drive_type - Tração: "FWD", "RWD", "AWD" ou "4WD". "4x2" significa que a IAAI não informou qual eixo é o motriz.

color, interior_color - Cor da carroceria e cor do interior.

displacement, displacement_cc - Cilindrada em litros, como a IAAI informa, e o mesmo valor em centímetros cúbicos (5,3 l equivalem a 5300).

engine - Motor como a IAAI o descreve, por exemplo "5.3L V-8 DI, VVT, 355HP".

cylinders - Número de cilindros.

power - Potência em cv. null nos híbridos e nos elétricos: a IAAI não publica a potência total do sistema.

power_ice_hp - Potência do motor a combustão em cv. Vem preenchido nos híbridos mesmo quando power é null.

power_electro_kw, seat_count - Potência do motor elétrico e número de lugares. A IAAI não publica esses dados, por isso os campos são sempre null.

Danos e título de propriedade

primary_damage, secondary_damage - Dano principal e dano secundário, por exemplo "Front end", "Left side", "Flood" ou "Hail".

loss_type - Motivo pelo qual o carro foi a leilão: "Collision", "Theft", "Flood", "Fire" ou "Other".

condition - Estado de funcionamento: "Run & drive", "Starts", "Stationary" ou "Can't test".

has_keys - Se há chaves do carro (true/false).

airbags - Estado dos airbags, por exemplo "Intact", "Deployed" ou "Missing".

restraint_system - Airbags e cintos de segurança presentes no carro.

catalytic_converter - Catalisador no lugar (true) ou removido (false).

title_group - Tipo de título de propriedade: "Clear", "Salvage", "Non-repairable" e outros. Nos lotes do Canadá, vem como a IAAI o escreve, por exemplo "ON-NOT BRANDED-ONTARIO". null enquanto o título não chegar à IAAI.

title_state - Estado ou província que emitiu o título.

title_brand, title_notes - Marcação no título e observações, como a IAAI as escreve, por exemplo "PREVIOUS SALVAGE".

declarations - Declarações do vendedor nos lotes do Canadá, com o texto como a IAAI o escreve, por exemplo "TKU" (quilometragem real desconhecida) ou uma menção ao relatório CARFAX.

Leilão, vendedor e localização

auction_at - Início do leilão ao vivo. null enquanto a IAAI não marcar a data. A marcação ou a remarcação da data do leilão não gera evento em /changes. /offer e /offers retornam a data e a hora mais recentes marcadas para o leilão.

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

timed_auction_close_at - Encerramento do leilão cronometrado.

branch, branch_id - Filial da IAAI onde o lote é vendido e o número da filial.

lane, run_number - Pista do leilão e número de ordem do lote nessa pista. A IAAI os atribui pouco antes do leilão; até lá, null. Assim como a data do leilão, eles não chegam como eventos separados em /changes.

is_public - true se o lote está aberto a compradores particulares (marcação Public). Quem mais pode comprar o lote está listado em who_can_buy.

who_can_buy - Quem pode comprar o lote: "Dealers", "Dismantlers", "Exporters", "Public" e outros. A IAAI preenche a lista mais perto do leilão; até lá, null.

seller_category - De onde o carro veio para o leilão: "Insurance company", "Remarketing", "Lease and rental", "Repossession" e outros.

seller_type, is_dealer, salon_id - Vendedor. A IAAI não o mostra, por isso esses campos são sempre null.

country - "USA" ou "Canada".

region, city - Estado ou província e cidade onde o carro está.

address, zip - Endereço e ZIP ou código postal do mesmo local.

latitude, longitude - Coordenadas do mesmo local. null nos lotes do Canadá.

Fotos, vídeos e dados de referência

photos - Links das fotos em tamanho original. Em um lote sem fotos, é um array vazio.

photo_360_url - Link para a visualização 360 no site da IAAI.

engine_video_url - Link para o vídeo do motor em funcionamento.

options - Equipamentos como a IAAI os lista, em um único grupo "Equipment".

original - Valores originais dos campos principais do iaai.com, sem tradução.

catalog_ids - Códigos de catálogo. A IAAI não os publica, por isso os valores são sempre null.

GET/change_id

Obter primeiro ID de alteração por data (para usar em /changes)

Parâmetros:

  • date (obrigatório) - data no formato yyyy-mm-dd
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10

Resposta:

{
  "change_id": 208400
}

Use o valor retornado como parâmetro change_id em /changes

GET/changes

Feed de alterações (adicionado/alterado/removido)

Parâmetros:

  • change_id (obrigatório) - a partir de qual ID de alteração
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412

Resposta:

{
  "result": [
    {
      "id": 208412,
      "inner_id": "46237543~US",
      "change_type": "changed",
      "created_at": "2026-11-10T03:12:40Z",
      "data": {  // novo preço Buy Now na moeda do lote (null se o Buy Now foi retirado)
        "new_price": 28225
      }
    },
    {
      "id": 208413,
      "inner_id": "47020463~US",
      "change_type": "added",
      "created_at": "2026-11-10T03:12:41Z",
      "data": { ... }  // o corpo completo do lote, como em /offers
    },
    {
      "id": 208414,
      "inner_id": "46769371~US",
      "change_type": "removed",
      "created_at": "2026-11-10T03:12:43Z",
      "data": {}  // lote retirado de venda
    }
    // ... depois os demais eventos, até 20 por página
  ],
  "meta": {
    "cur_change_id": 208412,
    "next_change_id": 208432,
    "limit": 20
  }
}

GET/offer

Um lote pelo inner_id.

Parâmetros:

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

A resposta traz apenas o objeto data, sem o result em volta dele.

Erros

Em caso de erro, a resposta traz o campo error com uma descrição: { "error": "parameter page is required" }

  • 401 - a api_key não foi aceita
  • 400 - falta um parâmetro obrigatório ou um valor está no formato errado
  • 404 - não há lote com esse inner_id (/offer)
  • 429 - o limite de requisições se esgotou

Retenção

Os ficheiros ficam disponíveis pelo menos 3 dias

Disponibilidade

Ficheiros novos todas as manhãs

Formato CSV

As colunas do CSV são separadas pelo caráter pipe (|)

Estrutura do URL:

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

Parâmetros:

  • access_name - o seu subdomínio pessoal
  • date - data da exportação no formato aaaa-mm-dd, por ex. 2026-11-10
  • file_name - nome do ficheiro com extensão

Ficheiros disponíveis:

  • 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

Exemplo de pedido 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

Exemplo de comando Wget

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

A IAAI (iaai.com) é o site da Insurance Auto Auctions (IAA). Desde 2023 a empresa faz parte da RB Global. Nos EUA e no Canadá, os carros são entregues a leilão por seguradoras, depois de uma colisão, inundação, incêndio ou furto, e também por bancos, concessionários e empresas de leasing e de aluguer.

Um lote é vendido num leilão ao vivo, num dia marcado, ou num leilão cronometrado, e alguns lotes podem ser comprados antes do leilão a um preço Buy Now. Certos lotes são vendidos apenas a compradores com licença, como concessionários, empresas de desmantelamento e exportadores, enquanto os lotes com a marcação Public estão abertos também a compradores particulares. A IAAI não torna públicos os lances nem os preços de venda.

Um importador vê no lote se os exportadores podem comprá-lo. Com o ano-modelo, a cilindrada e a potência do motor é possível estimar os direitos aduaneiros, e com os primeiros 11 caracteres do VIN é possível confirmar o modelo e a fábrica.

Através de /changes chegam os novos lotes, os novos preços Buy Now e as retiradas de venda. A retirada de venda nem sempre significa que o lote foi vendido.

Resposta em 2 min