API источника · Copart и IAAI · США # API Copart и IAAI — лоты аукционов США в JSON Copart и IAAI — два крупнейших аукциона США, где продают битые, страховые и подержанные машины. apiauto.space отдаёт лоты обоих аукционов с торгами впереди в одной записи: VIN, повреждения, тип документа, ставка и цена «купить сейчас», дата торгов, площадка и фото. Лоты, которых нет в нашей копии каталога, находит живой поиск: он спрашивает поставщика данных аукционов в момент запроса — на тарифах Pro и Max. - **Источник**: copart.com · iaai.com · market=us - **Регион**: США - **Данные**: Лоты, ставки, повреждения, фото - **Статус**: Работает · обновление каждый час ## Что содержит запись лота Одни и те же ключи у всех рынков; справа — значения двух настоящих лотов из каталога: Copart сверху, IAAI снизу. Чего аукцион не даёт, приходит как null, а не догадка. ### Лот - `title` Год, марка и модель одной строкой `"2019 Mercedes-Benz Sprinter"` `"2021 Alfa Romeo Giulia"` - `vin` VIN лота `"WD4PF1CDXKP120163"` `"ZARFANBN5M7644416"` - `year` Год выпуска `2019` `2021` - `mileage_km` Пробег в километрах `172294` `96536` - `raw.odometer_mi` Пробег в милях, как у аукциона `107059` `59985` - `raw.lot_number` Номер лота `"74596366"` `"46070355"` ### Торги и цена - `raw.sale_date` Дата и время торгов, UTC `"2026-11-09T17:00:00+00:00"` `"2026-11-09T14:30:00+00:00"` - `raw.bid` Текущая ставка, если аукцион её отдал `null` `25` - `raw.buy_now` Цена «купить сейчас» `21800` `4500` - `price` «Купить сейчас», после продажи — итоговая ставка; иначе null. Ставка — не цена `21800.00 USD` `4500.00 USD` ### Состояние - `raw.damage_main` Основное повреждение `"normal_wear"` `"front"` - `raw.damage_second` Дополнительное повреждение `null` `"mechanical"` - `raw.title_doc` Тип документа на машину `"clean"` `"salvage"` - `raw.keys_available` Есть ли ключи `true` `true` - `raw.source_values.damage_main` Исходная строка аукциона `"Normal wear"` `"Front end"` ### Машина - `fuel` Топливо, каноническое значение `"diesel"` `"gasoline"` - `transmission` Коробка передач `"automatic"` `"automatic"` - `engine_cc` Объём двигателя, см³ `3000` `2000` - `raw.source_values.engine` Строка двигателя от аукциона `"3.0L 6"` `"2.0L I-4 DI, VVT, turbo, premium…` - `color` Цвет `"Black"` `"Black"` - `raw.drive` Привод `"rwd"` `"awd"` ### Площадка и фото - `location.region` Штат `"NJ"` `"KY"` - `location.city` Город площадки `"Glassboro"` `"Louisville North"` - `raw.location_branch` Площадка аукциона `"NJ - GLASSBORO WEST"` `"Louisville North"` - `photo_count` Фото лота `13` `17` - `photos.0` Подписанная ссылка, живёт около суток `"api.apiauto.space/img/copart:745…` `"api.apiauto.space/img/iaai:46070…` ### Аукцион не даёт - `listing_url` Ссылки на лот не отдаём `null` `null` - `raw.final_bid` Финальной цены нет: только торги впереди `null` `null` - `raw.estimate_repair_price` Оценка ремонта — только если аукцион её дал `null` `null` copart:74596366 2019 Mercedes-Benz Sprinter · 172 294 км iaai:46070355 2021 Alfa Romeo Giulia · 96 536 км ## Запрос и ответ Четыре запроса, с которых обычно начинают. Ключ — в заголовке X-API-Key, ответ — JSON. Страница машин по фильтрам и курсор следующей GET `https://api.apiauto.space/v1/cars?market=us&limit=2` cURL: ```bash curl -s "https://api.apiauto.space/v1/cars?market=us&limit=2" \ -H "X-API-Key: $APIAUTO_KEY" ``` JavaScript: ```js const response = await fetch( "https://api.apiauto.space/v1/cars?market=us&limit=2", { headers: { "X-API-Key": process.env.APIAUTO_KEY } }, ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); const data = await response.json(); ``` Python: ```python import os import httpx data = httpx.get( "https://api.apiauto.space/v1/cars?market=us&limit=2", headers={"X-API-Key": os.environ["APIAUTO_KEY"]}, timeout=30, ).raise_for_status().json() ``` PHP: ```php ["X-API-Key: " . getenv("APIAUTO_KEY")], CURLOPT_RETURNTRANSFER => true, ]); $data = json_decode(curl_exec($ch), true); ``` 200 OK · пример ответа: ```json { "items": [ { "id": "copart:74596366", "market": "us", "source": "copart", "source_id": "74596366", "title": "2019 Mercedes-Benz Sprinter", "brand": "Mercedes-Benz", "model": "Sprinter", "generation": null, "trim": null, "year": 2019, "mileage_km": 172294, "fuel": "diesel", "transmission": "automatic", "engine_cc": 3000, "body_type": "minivan", "color": "Black", "vin": "WD4PF1CDXKP120163", "price": { "amount": "21800.00", "currency": "USD" }, "price_usd": "21800.00", "location": { "country": "US", "region": "NJ", "city": "Glassboro" }, "photos": [ "https://api.apiauto.space/img/copart:74596366/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/copart:74596366/2.jpg?exp=…&sig=…" ], "photo_count": 13, "listing_url": null, "is_active": true, "first_seen_at": "2026-11-03T04:44:39.124066Z", "last_seen_at": "2026-11-03T04:44:39.124066Z", "disappeared_at": null, "updated_at": "2026-11-03T04:44:39.124066Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "USD", "usd_per_unit": "1" }, "bid": null, "drive": "rwd", "status": 3, "airbags": null, "buy_now": 21800, "latitude": 39.68909, "condition": null, "cylinders": 6, "final_bid": null, "longitude": -75.13209, "sale_date": "2026-11-09T17:00:00+00:00", "title_doc": "clean", "video_url": null, "grade_iaai": null, "lot_number": "74596366", "damage_main": "normal_wear", "odometer_mi": 107059, "damage_second": null, "source_values": { "fuel": "1", "trim": null, "brand": "MERCEDES-BENZ", "drive": "1", "model": "SPRINTER", "engine": "3.0L 6", "body_type": "Van passenger", "title_doc": "CERT OF TITLE", "damage_main": "Normal wear", "transmission": "1", "damage_second": null }, "keys_available": true, "location_branch": "NJ - GLASSBORO WEST", "odometer_status": null, "pre_accident_price": null, "clean_wholesale_price": null, "estimate_repair_price": null }, "source_mode": "replica" }, { "id": "iaai:46070355", "market": "us", "source": "iaai", "source_id": "46070355", "title": "2021 Alfa Romeo Giulia", "brand": "Alfa Romeo", "model": "Giulia", "generation": null, "trim": null, "year": 2021, "mileage_km": 96536, "fuel": "gasoline", "transmission": "automatic", "engine_cc": 2000, "body_type": "sedan", "color": "Black", "vin": "ZARFANBN5M7644416", "price": { "amount": "4500.00", "currency": "USD" }, "price_usd": "4500.00", "location": { "country": "US", "region": "KY", "city": "Louisville North" }, "photos": [ "https://api.apiauto.space/img/iaai:46070355/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/iaai:46070355/2.jpg?exp=…&sig=…" ], "photo_count": 17, "listing_url": null, "is_active": true, "first_seen_at": "2026-11-03T00:32:38.013200Z", "last_seen_at": "2026-11-03T04:31:44.032962Z", "disappeared_at": null, "updated_at": "2026-11-03T04:31:44.032962Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "USD", "usd_per_unit": "1" }, "bid": 25, "drive": "awd", "status": 3, "airbags": 2, "buy_now": 4500, "latitude": 38.37074, "condition": null, "cylinders": 4, "final_bid": null, "longitude": -85.19097, "sale_date": "2026-11-09T14:30:00+00:00", "title_doc": "salvage", "video_url": null, "grade_iaai": null, "lot_number": "46070355", "damage_main": "front", "odometer_mi": 59985, "damage_second": "mechanical", "source_values": { "fuel": "4", "trim": null, "brand": "ALFA ROMEO", "drive": "3", "model": "GIULIA", "engine": "2.0L I-4 DI, VVT, turbo, premium , 280HP", "body_type": "Sedan", "title_doc": "SALVAGE", "damage_main": "Front end", "transmission": "1", "damage_second": "Mechanical" }, "keys_available": true, "location_branch": "Louisville North", "odometer_status": null, "pre_accident_price": null, "clean_wholesale_price": null, "estimate_repair_price": null }, "source_mode": "replica" } ], "next_cursor": "…", "count": null } ``` Машины в ответах настоящие, из каталога на момент сборки сайта; фото сокращены до двух, id событий условные. ## Соберите запрос Выберите фильтры — адрес и код соберутся сами. Рынок закреплён: market=us отдаёт лоты Copart и IAAI вместе, аукцион видно по полю source. GET `https://api.apiauto.space/v1/cars?market=us&brand=Toyota&limit=20` cURL: ```bash curl -s "https://api.apiauto.space/v1/cars?market=us&brand=Toyota&limit=20" \ -H "X-API-Key: $APIAUTO_KEY" ``` JavaScript: ```js const response = await fetch( "https://api.apiauto.space/v1/cars?market=us&brand=Toyota&limit=20", { headers: { "X-API-Key": process.env.APIAUTO_KEY } }, ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); const data = await response.json(); ``` Python: ```python import os import httpx data = httpx.get( "https://api.apiauto.space/v1/cars?market=us&brand=Toyota&limit=20", headers={"X-API-Key": os.environ["APIAUTO_KEY"]}, timeout=30, ).raise_for_status().json() ``` PHP: ```php ["X-API-Key: " . getenv("APIAUTO_KEY")], CURLOPT_RETURNTRANSFER => true, ]); $data = json_decode(curl_exec($ch), true); ``` ## Сценарии 1. **Подбор машины из США под клиента** — 01 Подбор машины из США под клиентаМенеджер ищет лоты по марке, году и бюджету и отправляет клиенту VIN, повреждения, дату торгов и фото. Метод`GET /v1/cars?market=us&brand=…` 2. **Калькулятор «под ключ»** — 02 Калькулятор «под ключ»Ставка, «купить сейчас», штат и площадка лота — всё, чтобы посчитать доставку и растаможку у себя. Метод`GET /v1/cars/{id}` 3. **Новые лоты в Telegram-канал** — 03 Новые лоты в Telegram-каналЛента added приносит свежие лоты с торгами впереди — бот публикует их с фото. Метод`GET /v1/changes?market=us&type=added` 4. **Поиск за пределами копии** — 04 Поиск за пределами копииЕсли нужного лота нет в копии, живой поиск ищет его прямо у поставщика данных аукционов — на тарифах Pro и Max. Метод`GET /v1/us/live?make=…` ## Об источнике Поля аукционов, марки в каталоге, живой поиск, лента и границы данных США. ### Поля аукциона в raw | Поле | Что значит | | --- | --- | | `sale_date` | Дата и время торгов, UTC. | | `bid`, `buy_now` | Текущая ставка и цена «купить сейчас». | | `damage_main`, `damage_second` | Основное и дополнительное повреждение: front, rear, normal_wear… | | `title_doc` | Тип документа на машину: clean и другие; исходная строка — в `source_values`. | | `odometer_mi`, `odometer_status` | Пробег в милях, как у аукциона, и его статус. | | `keys_available` | Есть ли ключи. | | `lot_number`, `location_branch` | Номер лота и площадка аукциона. | | `drive`, `cylinders` | Привод и число цилиндров. | | `pre_accident_price`, `clean_wholesale_price`, `estimate_repair_price` | Оценки стоимости и ремонта, когда аукцион их даёт. | | `video_url` | Видео лота, если есть. | ### Марки на аукционах в каталоге Самые частые марки: | Марка | Машин в каталоге | | --- | --- | | Toyota | 8 373 | | Ford | 7 184 | | Honda | 6 710 | | Chevrolet | 6 469 | | Nissan | 5 776 | | Hyundai | 4 686 | | Kia | 3 784 | | Jeep | 3 206 | | Mercedes-Benz | 2 828 | | BMW | 2 578 | | Subaru | 2 381 | | Dodge | 2 086 | Полный список — `GET /v1/references/brands?market=us`, бесплатно. ### Живой поиск за пределами копии `GET /v1/us/live` ищет лоты прямо у поставщика данных аукционов — для машин, которых нет в копии. Параметры: `make`, `model`, `year_min`, `year_max`, `price_max`, `page`. У живого поиска отдельный месячный счётчик: Pro — 2 000 запросов, Max — 10 000. Когда поставщик недоступен, ответ — 503 с `retry_after`. ### Новые лоты и прошедшие торги Лента `GET /v1/changes?market=us` отдаёт новые лоты (`added`), лоты с прошедшими торгами (`disappeared`) и изменения цены. После торгов лот получает `is_active=false` и остаётся в API ещё 14 дней. ### Границы данных США - Только лоты с торгами впереди. Архива прошедших торгов, финальных цен и истории продаж нет. - API только читает данные: ставки делаются на аукционе, через аккаунт участника или брокера. - Кузов указан не у всех лотов, ссылки на лот нет. - Возраст копии приходит в заголовке `X-Data-Age-Seconds` каждого ответа. ## Частые вопросы ### 01Это официальный API Copart или IAAI? Нет. apiauto.space не связан с Copart и IAAI. Мы отдаём копию лотов с предстоящими торгами в своём едином формате — том же, что у Encar и Che168. ### 02Есть ли история продаж и финальные цены? Нет. В копии только лоты, торги по которым ещё впереди; после торгов лот становится неактивным и через 14 дней уходит. Архив продаж мы не продаём. ### 03Можно ли делать ставки через API? Нет, API только для чтения. Ставки делаются на аукционе — через аккаунт участника или брокера. ### 04Подходит ли для Telegram-бота с лотами США? Да: бот на своём сервере запрашивает /v1/cars?market=us с фильтрами, а о новых лотах узнаёт из ленты /v1/changes. Ключ держите на сервере бота. ### 05Сколько стоит API Copart и IAAI? Тариф Start — $59 в месяц за один рынок, например только США: 100 000 машин в месяц. Живой поиск — на Pro ($149, 2 000 запросов) и Max ($299, 10 000). Демо — сутки и 100 запросов без оплаты. ## Другие API и руководства - [API источника **API Copart**](https://apiauto.space/copart-api/) - [API источника **API IAAI**](https://apiauto.space/iaai-api/) - [API источника **API Encar**](https://apiauto.space/encar-api/) - [API источника **API Che168**](https://apiauto.space/che168-api/) - [Руководство **Каталог авто на сайт импортёра**](https://apiauto.space/importers/) - [Разработчикам **Документация**](https://apiauto.space/docs/) ## Получите тестовый ключ Copart и IAAI - Сутки и 100 запросов бесплатно, без карты - Все три рынка и лента изменений: США можно сравнить с Кореей и Китаем - Ключ приходит в Telegram за минуту — без формы и звонков --- Страница: https://apiauto.space/copart-iaai-api/