AUTO-API.COM
Лого на IAAI

IAAI APIScraper & Parser

IAAI API: застрахователни търгове в САЩ и Канада с Buy Now, ACV и оценка на ремонта, щети, документ за собственост и дата на търга. Поток от промени и файлове.

Официални SDK библиотеки

Нашите SDK библиотеки включват методите на API-то като готови функции, а самите библиотеки са с отворен код в GitHub.

IAAI API

Парсърът събира лотове от IAAI, застрахователните автомобилни търгове в САЩ и Канада, включително леки автомобили, SUV, пикапи и ванове. Чрез API можете да подбирате лотове според изискванията на купувача и да ги следите в потока от промени, докато не бъдат свалени от продажба. Не е нужно да пишете и поддържате собствен скрейпър за iaai.com.

API

Потокът /changes връща събития за лотовете на IAAI: нов лот, нова цена Buy Now, сваляне от продажба.

Ежедневни експорти

Ежедневният експорт съдържа лотовете на IAAI, които са в продажба към датата на експорта.

Пълни данни

Пробег и статус на одометъра, двигател и мощност, щети, причина за продажбата, вид на документа за собственост, ключове и въздушни възглавници, дата на търга и клон, допуснати купувачи, снимки и видео на работещия двигател.

Получете достъп до APIДостъпът се предоставя до 2 минути

Лотът има два номера: inner_id, с който получавате лота от /offer, и stock_number, номерът, под който купувачите го познават на търговете на IAAI.

Базов URL

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

Оторизация: api_key параметър

Ред на работа

1
/filtersполучаване на наличните стойности на филтрите
2

Първоначално зареждане:

/change_id?date=...получаване на началното ID за потока от промени
/offersполучаване на всички лотове страница по страница
3
/changes?change_id=...получаване на всички промени в базата данни, като се започне от ID
4
/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": ["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

Лотове страница по страница. Филтрите стесняват резултатите.

Параметри:

  • 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=Pickup&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": "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": {  // оригинални стойности от 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"]
        }
      }
    }
    // ... следват останалите лотове, до 20 на страница
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Полета с данни:

Лот

id - вътрешно ID в базата данни

inner_id - ID на лота от връзката в IAAI, с пазара след тилдата: "43963919~US", а при канадските лотове във вида "Imp_3139055~CA". Именно това ID приема /offer.

stock_number - Stock#, номерът на лота, който IAAI показва на сайта си и на търга.

url - Връзка към лота.

price, currency - Цена Buy Now и валута, USD или CAD. Ако лотът няма цена Buy Now, price е null.

acv - ACV, оценка на стойността на автомобила преди щетата.

repair_cost - Оценка на стойността на ремонта.

section - Винаги "Used".

description - Описание от продавача. Лотовете в IAAI нямат описание, затова полето винаги е null.

created_at - Дата и час, когато лотът е постъпил в нашата база данни.

offer_created - Дата и час на публикуване на лота, както ги посочва IAAI. 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 - Статус на одометъра, например "Actual", "Not actual", "Exceeds mechanical limits" или "Exempt" (по-старите автомобили са освободени от деклариране на пробега).

owners_count - Брой собственици. IAAI не го публикува, затова винаги е null.

vehicle_type - Тип превозно средство по класификацията на IAAI, например "Automobile", "Light truck" или "Classic car". Типът каросерия идва в body_type.

country_of_origin - Държава на сглобяване.

Характеристики

engine_type - Гориво: "Gasoline", "Diesel", "Hybrid", "Electric", "Flex fuel" или "Other".

transmission_type - "Automatic", "Manual" или "CVT".

body_type - Тип каросерия, например "SUV" или "Pickup". Наименованието на каросерията, както го изписва IAAI, е в original.body_type.

drive_type - Задвижване: "FWD", "RWD", "AWD" или "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 - Основна и допълнителна щета, например "Front end", "Left side", "Flood" или "Hail".

loss_type - Защо автомобилът е попаднал на търг: "Collision", "Theft", "Flood", "Fire" или "Other".

condition - Статус при запалване: "Run & drive", "Starts", "Stationary" или "Can't test".

has_keys - Дали има ключове за автомобила (true/false).

airbags - Състояние на въздушните възглавници, например "Intact", "Deployed" или "Missing".

restraint_system - Какви въздушни възглавници и предпазни колани има автомобилът.

catalytic_converter - Катализаторът е на мястото си (true) или е демонтиран (false).

title_group - Вид на документа за собственост: "Clear", "Salvage", "Non-repairable" и други. При канадските лотове идва така, както го изписва IAAI, например "ON-NOT BRANDED-ONTARIO". null, докато документът не е постъпил в IAAI.

title_state - Щат или провинция, където е издаден документът за собственост.

title_brand, title_notes - Отметка и бележки в документа за собственост, както ги изписва IAAI, например "PREVIOUS SALVAGE".

declarations - Декларации на продавача при канадските лотове, текстът както го изписва IAAI, например "TKU" (действителният пробег е неизвестен) или препратка към доклада от CARFAX.

Търг, продавач и местоположение

auction_at - Начало на търга на живо. null, докато IAAI не определи датата. Насрочването или пренасрочването на търга не създава събитие в /changes. /offer и /offers връщат последно насрочените дата и час на търга.

auction_type - "Live auction" или "Timed auction".

timed_auction_close_at - Край на търга с таймер.

branch, branch_id - Клон на IAAI, в който се продава лотът, и номер на клона.

lane, run_number - Линия на търга и пореден номер на лота в нея. IAAI ги определя малко преди търга, дотогава са null. Както и датата на търга, те не пристигат като отделни събития в /changes.

is_public - true, ако лотът е достъпен за частни купувачи (отметката Public). Кой друг може да купи лота, е посочено в who_can_buy.

who_can_buy - Кой може да купи лота: "Dealers", "Dismantlers", "Exporters", "Public" и други. IAAI попълва списъка по-близо до търга, дотогава е null.

seller_category - Откъде автомобилът е дошъл на търга: "Insurance company", "Remarketing", "Lease and rental", "Repossession" и други.

seller_type, is_dealer, salon_id - Продавач. IAAI не го показва, затова тези полета винаги са null.

country - "USA" или "Canada".

region, city - Щат или провинция и град, където се намира автомобилът.

address, zip - Адрес и ZIP или пощенски код на същото място.

latitude, longitude - Координати на същото място. При канадските лотове са null.

Снимки, видеа и справочни данни

photos - Връзки към снимките в пълен размер. При лот без снимки полето е празен масив.

photo_360_url - Връзка към 360° изгледа на сайта на IAAI.

engine_video_url - Връзка към видеото на работещия двигател.

options - Оборудване, както го изброява IAAI, в една група "Equipment".

original - Оригиналните стойности на основните полета от iaai.com, без превод.

catalog_ids - Кодове в каталога. IAAI не ги публикува, затова стойностите винаги са null.

GET/change_id

Получаване на първото ID на промяна по дата (за използване в /changes)

Параметри:

  • date (задължително) - дата във формат yyyy-mm-dd
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 (задължително) - от кое 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 са разделени с вертикална черта (|)

Структура на URL адреса:

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

Параметри:

  • access_name - вашият личен поддомейн
  • date - дата на експорта във формат yyyy-mm-dd, напр. 2026-11-10
  • file_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 (iaai.com) е сайтът на Insurance Auto Auctions (IAA). От 2023 г. компанията е част от RB Global. Автомобилите на търговете в САЩ и Канада идват от застрахователни компании след произшествие, наводнение, пожар или кражба, както и от банки, дилъри, лизингови компании и фирми за автомобили под наем.

Лотът се продава на търг на живо в определен ден или на търг с таймер, а част от лотовете могат да бъдат купени преди търга на цена Buy Now. Някои лотове се продават само на купувачи с лиценз, например дилъри, автоморги и износители, а лотовете с отметката Public са достъпни и за частни купувачи. IAAI не публикува наддаванията и продажните цени.

Вносителят вижда в лота дали износителите имат право да го купят. По моделната година, обема и мощността на двигателя можете да пресметнете приблизително митата при внос, а по първите 11 знака от VIN да проверите модела и завода.

Новите лотове, новите цени Buy Now и свалените от продажба лотове пристигат чрез метода /changes. Свалянето от продажба не винаги означава, че лотът е продаден.

Отговор до 2 мин