
IAAI APIПарсер и скрапер
IAAI API: лоты страховых аукционов США и Канады с ценой Buy Now, оценками ACV и ремонта, повреждениями, видом документа и датой торгов. Лента изменений и файлы.
IAAI API
Парсер собирает лоты легковых машин, внедорожников, пикапов и фургонов с IAAI, страховых автоаукционов США и Канады. По API лоты можно отбирать фильтрами под заказ и вести по ленте изменений до снятия с продажи. Писать и поддерживать свой скрапер iaai.com не нужно.
Лента /changes отдает события по лотам IAAI: новый лот, новая цена Buy Now, снятие с продажи.
В ежедневной выгрузке собраны лоты IAAI, которые в продаже на день выгрузки.
Пробег и статус одометра, двигатель и мощность, повреждения, причина продажи, вид документа, ключи и подушки безопасности, дата торгов и филиал, допуск к покупке, фото и видео работы двигателя.
У лота два номера: inner_id, по которому лот запрашивают в /offer, и stock_number, под которым его знают на торгах IAAI.
Базовый URL
https://{access_name}.auto-api.com/api/v3/iaaiАвторизация: api_key параметр
Алгоритм работы
/filtersполучить справочники и значения фильтровПервая загрузка:
/change_id?date=...получить стартовый ID для потока изменений/offersзабрать все лоты, страница за страницей/changes?change_id=...получить поток изменений (дельту) начиная с указанного ID/offerодин лот по inner_idС чего начать:
1. Перед первой загрузкой возьмите номер из /change_id за сегодняшнюю дату и запомните его. Затем пройдите /offers по страницам до конца выдачи: на последней next_page равен null.
2. Потом опрашивайте /changes с этого номера и каждый раз передавайте next_change_id из ответа. Так приходят новые лоты, новые цены Buy Now и снятия лотов с продажи. Если next_change_id равен null, событий пока нет: повторите тот же запрос позже.
3. Для поиска под свои условия запрашивайте /offers с фильтрами.
Формат данных
- Типы сохраняются: число приходит числом, список массивом, отсутствующее значение как null.
- Моменты времени даны в UTC, например "2026-11-12T14:30:00Z".
- Цена, ACV и оценка ремонта указаны в валюте лота: USD у лотов из США, CAD у лотов из Канады.
- Набор полей одинаков у всех лотов. Если значения нет, в поле null, например в auction_at, пока IAAI не назначил дату торгов. Исключение photos: у лота без фото там пустой массив.
GET/filters
Справочники и возможные значения для фильтрации
https://{access_name}.auto-api.com/api/v3/iaai/filters?api_key=YOUR_API_KEYОтвет:
{
"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": ["Автомат", "Вариатор", "Механика"],
"color": ["Бежевый", "Белый", "Бирюзовый", "Бордовый", ...],
"body_type": [..., "Внедорожник", "Грузовой фургон", "Кабриолет", "Купе", ...],
"engine_type": ["Бензин", "Бензин или этанол (Flex Fuel)", "Гибрид", "Дизель", "Другое", "Электро"],
"drive_type": [..., "Задний", "Передний", "Передний или задний (4x2)", "Полный", "Полный (4x4)"]
}GET/offers
Лоты по страницам, выборку можно сузить фильтрами.
Параметры:
page(обязательно) - номер страницыmark, model- марка и модель как в /filters, регистр не важенtransmission_type, color, body_type, engine_type, drive_type- коробка, цвет, кузов, топливо и привод значениями из /filters, регистр не важенyear_from, year_to- модельный год от и доkm_age_from, km_age_to- пробег в км от и доprice_from, price_to- цена Buy Now от и до в валюте лота. Лоты без Buy Now с этими фильтрами не приходят
Чтобы передать в фильтр несколько значений, повторите параметр со скобками: 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=Пикап&price_to=15000Ответ:
{
"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": "Не фактический",
"owners_count": null,
"price": 14000,
"currency": "USD",
"acv": 38323,
"repair_cost": 25348,
"engine_type": "Бензин",
"transmission_type": "Автомат",
"body_type": "Внедорожник",
"drive_type": "Передний или задний (4x2)",
"color": "Серый",
"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": "Б/у",
"seller_type": null,
"is_dealer": null,
"salon_id": null,
"seller_category": "Страховая компания",
"region": "Джорджия",
"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": "Живые торги",
"timed_auction_close_at": null,
"branch": "Atlanta East",
"branch_id": "707",
"lane": "D",
"run_number": 153,
"country": "США",
"primary_damage": "Правая задняя часть",
"secondary_damage": "Задняя часть",
"loss_type": "Столкновение",
"title_group": "После страхового случая (Salvage)",
"title_state": "Джорджия",
"title_brand": null,
"title_notes": null,
"condition": "На ходу",
"has_keys": true,
"airbags": "Целы",
"catalytic_converter": true,
"is_public": true,
"who_can_buy": ["Дилеры", "Разборщики", "Экспортеры", "Прочие компании с лицензией", "Компании с лицензией не на авто", "Частные лица", "Восстановители", "Утилизаторы"],
"vehicle_type": "Внедорожник",
"country_of_origin": "США",
"restraint_system": ["Фронтальная подушка водителя", "Боковая подушка водителя", "Шторки безопасности", "Фронтальная подушка пассажира", "Боковая подушка пассажира", "Передняя центральная подушка"],
"declarations": null,
"original": { // исходные значения с 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": {
"Оснащение": ["Дисплей на центральной консоли"]
}
}
}
// ... дальше остальные лоты, на странице их до 20
],
"meta": {
"page": 1,
"next_page": 2,
"limit": 20
}
}Поля данных:
Лот
id - внутренний ID базы данных
inner_id - ID лота из ссылки на IAAI и рынок после тильды: «43963919~US», у канадских лотов вида «Imp_3139055~CA». Его принимает /offer.
stock_number - Stock#, номер лота, который IAAI показывает на сайте и на торгах.
url - Ссылка на лот.
price, currency - Цена Buy Now и валюта, USD или CAD. Если Buy Now у лота нет, price равен null.
acv - ACV, оценка стоимости машины до повреждения.
repair_cost - Оценка стоимости ремонта.
section - Всегда «Б/у».
description - Текст продавца. У лотов IAAI его нет, поэтому всегда null.
created_at - Время, когда лот попал к нам.
offer_created - Время выставления лота, как его указывает IAAI. Площадка его обновляет, например при повторном выставлении или переносе торгов, поэтому оно бывает позже created_at.
Автомобиль
mark, model - Марка и модель, как их пишет IAAI: «CHEVROLET», «TAHOE».
complectation - Комплектация, например «2WD LT».
year - Модельный год.
first_registration - Первая регистрация. IAAI ее не публикует, поэтому всегда null.
vin - VIN в том виде, как его показывает IAAI: первые 11 знаков, остальные скрыты звездочками.
km_age - Пробег в км. Если вместо пробега IAAI пишет 0 или 1 (одометр не читается, не работает или пробег не учитывается), null.
odometer, odometer_unit - Показание одометра, как на IAAI, и единица: «mi» (мили) или «km».
odometer_status - Статус пробега, например «Фактический», «Не фактический», «Больше предела счетчика» или «Не подлежит учету» (у старых машин пробег не учитывают).
owners_count - Сколько было владельцев. IAAI это не публикует, поэтому всегда null.
vehicle_type - Тип машины по классификации IAAI, например «Легковой», «Легкий грузовик» или «Классический автомобиль». Вид кузова приходит в body_type.
country_of_origin - Страна сборки.
Характеристики
engine_type - Топливо: «Бензин», «Дизель», «Гибрид», «Электро», «Бензин или этанол (Flex Fuel)» или «Другое».
transmission_type - «Автомат», «Механика» или «Вариатор».
body_type - Вид кузова, например «Внедорожник» или «Пикап». Название кузова, как его пишет IAAI, лежит в original.body_type.
drive_type - Привод: «Передний», «Задний», «Полный» (AWD) или «Полный (4x4)» (4WD). «Передний или задний (4x2)» значит, что IAAI не уточнил, какой мост ведущий.
color, interior_color - Цвет кузова и цвет салона.
displacement, displacement_cc - Объем двигателя в литрах, как у IAAI, и он же в см³ (5.3 л это 5300).
engine - Двигатель, как его описывает IAAI, например «5.3L V-8 DI, VVT, 355HP».
cylinders - Число цилиндров.
power - Мощность в л.с. У гибридов и электромобилей null: мощность всей системы IAAI не публикует.
power_ice_hp - Мощность двигателя внутреннего сгорания в л.с. У гибридов заполнена, даже когда power равен null.
power_electro_kw, seat_count - Мощность электромотора и число мест. IAAI их не публикует, поэтому всегда null.
Повреждения и документ
primary_damage, secondary_damage - Основное и дополнительное повреждение, например «Передняя часть», «Левый бок», «Затопление» или «Град».
loss_type - Почему машина попала на аукцион: «Столкновение», «Угон», «Затопление», «Пожар» или «Другое».
condition - Отметка о запуске: «На ходу», «Заводится», «Не заводится» или «Не проверялся».
has_keys - Есть ли ключи (true/false).
airbags - Состояние подушек безопасности, например «Целы», «Сработали» или «Отсутствуют».
restraint_system - Какие подушки и ремни безопасности есть в машине.
catalytic_converter - Катализатор на месте (true) или снят (false).
title_group - Вид документа на машину: «Чистый (Clear)», «После страхового случая (Salvage)», «Не подлежит восстановлению (Non-Repairable)» и другие. У канадских лотов приходит как у IAAI, например «ON-NOT BRANDED-ONTARIO». Пока документ не поступил на IAAI, null.
title_state - Штат или провинция, где выдан документ.
title_brand, title_notes - Отметка и примечание к документу, как их пишет IAAI, например «PREVIOUS SALVAGE».
declarations - Декларации продавца у канадских лотов, текст как у IAAI, например «TKU» (настоящий пробег неизвестен) или отметка об отчете CARFAX.
Торги, продавец и место
auction_at - Начало живых торгов. Пока IAAI не назначил дату, null. Событий о назначении и переносе торгов в /changes нет, свежую дату отдают /offer и /offers.
auction_type - «Живые торги» или «Торги с таймером».
timed_auction_close_at - Окончание торгов с таймером.
branch, branch_id - Филиал IAAI, где продают лот, и номер филиала.
lane, run_number - Дорожка торгов (lane) и номер лота в очереди на ней. IAAI назначает их незадолго до торгов, до этого null. Как и дата торгов, отдельным событием в /changes они не приходят.
is_public - true, если лот доступен частным покупателям (отметка Public). Кто еще может купить лот, перечислено в who_can_buy.
who_can_buy - Кто может купить лот: «Дилеры», «Разборщики», «Экспортеры», «Частные лица» и другие. Список IAAI заполняет ближе к торгам, до этого null.
seller_category - Откуда машина пришла на аукцион: «Страховая компания», «Ремаркетинг (дилеры, банки, лизинг)», «Лизинг и прокат», «Изъятие за долги» и другие.
seller_type, is_dealer, salon_id - Продавец. IAAI его не показывает, поэтому всегда null.
country - «США» или «Канада».
region, city - Штат или провинция и город, где стоит машина.
address, zip - Адрес и индекс того же места.
latitude, longitude - Координаты того же места. У канадских лотов null.
Фото, видео и справочники
photos - Ссылки на фото в исходном размере. У лота без фото пустой массив.
photo_360_url - Ссылка на обзор 360 на сайте IAAI.
engine_video_url - Ссылка на видео работы двигателя.
options - Оснащение по данным IAAI, одной группой «Оснащение».
original - Исходные значения основных полей с iaai.com, без перевода.
catalog_ids - Коды каталога. IAAI их не публикует, поэтому значения всегда null.
GET/change_id
Получить первый ID изменения на конкретную дату (для /changes)
Параметры:
date(обязательно) - дата в формате гггг-мм-дд
https://{access_name}.auto-api.com/api/v3/iaai/change_id?api_key=YOUR_API_KEY&date=2026-11-10Ответ:
{
"change_id": 208400
}Используйте это значение как параметр change_id в /changes
GET/changes
Поток изменений (новые/измененные/удаленные)
Параметры:
change_id(обязательно) - начиная с какого change_id
https://{access_name}.auto-api.com/api/v3/iaai/changes?api_key=YOUR_API_KEY&change_id=208412Ответ:
{
"result": [
{
"id": 208412,
"inner_id": "46237543~US",
"change_type": "changed",
"created_at": "2026-11-10T03:12:40Z",
"data": { // новая цена Buy Now в валюте лота (null, если Buy Now убрали)
"new_price": 28225
}
},
{
"id": 208413,
"inner_id": "47020463~US",
"change_type": "added",
"created_at": "2026-11-10T03:12:41Z",
"data": { ... } // тело лота целиком, как в /offers
},
{
"id": 208414,
"inner_id": "46769371~US",
"change_type": "removed",
"created_at": "2026-11-10T03:12:43Z",
"data": {} // лот снят с продажи
}
// ... дальше остальные события, на странице их до 20
],
"meta": {
"cur_change_id": 208412,
"next_change_id": 208432,
"limit": 20
}
}GET/offer
Один лот по inner_id.
Параметры:
inner_id(обязательно)
https://{access_name}.auto-api.com/api/v3/iaai/offer?api_key=YOUR_API_KEY&inner_id=43963919~USВ ответе только объект data, без result вокруг него.
Ошибки
При ошибке в ответе приходит поле error с описанием: { "error": "parameter page is required" }
401- ключ api_key не подошел400- пропущен обязательный параметр или значение не того формата404- лота с таким inner_id нет (/offer)429- исчерпан лимит запросов
Срок хранения
Файлы доступны минимум 3 дня
Время готовности
Новые файлы каждое утро
Формат CSV
Разделитель полей в CSV: вертикальная черта «|»
Структура ссылки:
Параметры:
access_name- ваш персональный поддоменdate- дата выгрузки в формате гггг-мм-дд, например 2026-11-10file_name- имя файла с расширением
Доступные файлы:
- 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
Пример запроса 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Пример команды Wget
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'IAAI (iaai.com) это сайт аукционов Insurance Auto Auctions (IAA). С 2023 года компания входит в RB Global. Машины на торги в США и Канаде сдают страховые компании после ДТП, затопления, пожара или угона, а также банки, дилеры, лизинговые и прокатные компании.
Лот продают на живых торгах в назначенный день или на торгах с таймером. У части лотов есть цена Buy Now, по которой лот можно купить до торгов. Некоторые лоты продают только покупателям с лицензией, например дилерам, разборщикам и экспортерам, а лоты с отметкой Public доступны и частным покупателям. Ставки и цену продажи IAAI в открытом доступе не публикует.
Импортер видит в лоте, допущены ли к покупке экспортеры. По модельному году, объему и мощности двигателя можно прикинуть пошлину, а по первым 11 знакам VIN сверить модель и завод.
Через /changes приходят новые лоты, новые цены Buy Now и снятия с продажи. Снятие с продажи не всегда значит, что лот продан.
Расширьте охват автомобильных данных по мировым рынкам с помощью наших API платформ: