Аукціони США2 хв читання

Copart API: дані лотів, фото й фінальні ставки в JSON

Copart щодня виставляє на продаж нові авто, і кожен лот має VIN, опис пошкоджень, документ на право власності та галерею фото з майданчика. У цьому посібнику показано, як ці дані виглядають через API і як підтримувати їх актуальними без парсингу сторінок.

Про що йдеться?

01/ 05Стаття

Що продає Copart

Copart – один із найбільших онлайн-аукціонів авто в Північній Америці. Більшість його лотів надходить від страхових компаній, які продають авто, списані після ДТП, повені чи викрадення. Там також продають банки, прокатні автопарки, дилери й приватні власники.

Тому Copart – головний постачальник для імпортерів у Європі, на Близькому Сході та в Центральній Азії, для СТО та розбірок. Усім їм перед ставкою потрібне одне: надійні дані про авто, отримані вчасно.

Що містить лот Copart

Лот в API – це одне авто, виставлене на одному продажу. Його запис зберігає все, що показує сторінка лота, у фіксованих полях, на які можна покластися:

  • VIN, марка, модель, покоління, рік, двигун, пальне, коробка передач і привід
  • Основне й додаткове пошкодження, подушки безпеки, ключі та стан «на ходу»
  • Тип документа на право власності та штат, пробіг у милях і кілометрах
  • Майданчик, місто й штат, з координатами для мапи
  • Дата продажу, поточна ставка, ціна Buy Now і резерв продавця, якщо Copart його показує
  • Повна фотогалерея в кількох розмірах, а також відео й огляд 360°, якщо вони є

Актуальна копія без парсингу

Парсинг сторінок Copart ламається щоразу, коли сайт змінюється, і блокується, щойно навантаження зростає. З API ви один раз завантажуєте всі лоти, а потім кожні кілька хвилин запитуєте лише ті, що змінилися: нові лоти, нові ставки, нові дати продажу.

Посібник із синхронізації покроково показує цей цикл. Продані лоти зникають з активного списку й переходять до архіву разом із фінальною ставкою, тож ваша копія ніколи не покаже авто доступним після продажу.

Поточна ставка, Buy Now, резерв і фінальна ставка

Ці чотири числа легко сплутати. Поточна ставка – найвища ставка, поки лот відкритий. Buy Now – фіксована ціна, за якою деякі лоти можна купити до продажу. Резерв продавця, якщо Copart його показує, – це мінімум, на який розраховує продавець: це не ціна, яку хтось заплатив.

Фінальна ставка – найвища ставка на момент закриття торгів. Це найкраща відповідь на запитання, скільки коштує авто, а посібник із фінальних цін пояснює, як нею користуватися.

Copart та IAAI в одному форматі

Більшість покупців стежать за обома великими аукціонами США. Через MotorAPIs лоти IAAI надходять у точно такому самому записі, що й лоти Copart, тож один парсер і одна таблиця в базі даних обробляють обидва, а пошук може охопити обидва аукціони одразу.

Чого API не робить

MotorAPIs – це API даних. Він не робить ставок, не купує авто і не замінює членство в Copart чи брокера. Ви ухвалюєте рішення на основі даних, а ставки робите на Copart так само, як і зараз.

Як виглядає запит?

02/ 05Запити

Як виглядають запити

Кожен виклик – звичайний GET-запит із вашим ключем у заголовку x-api-key. У відповідь – JSON.

  1. 01Лоти Copart, змінені за останню годину

    GET https://motorapis.com/api/cars?domain_id=3&minutes=60
    x-api-key: YOUR_API_KEY
  2. 02Один лот за його номером

    GET https://motorapis.com/api/search-lot/{lot}/copart_com
    x-api-key: YOUR_API_KEY
  3. 03Авто за VIN з історією цін

    GET https://motorapis.com/api/search-vin/{vin}?prices_history=1
    x-api-key: YOUR_API_KEY

Щось іще?

03/ 05Запитання

Запитання

Чи є офіційний API Copart?
Copart не надає відкритого API даних для всіх. MotorAPIs читає лоти й повертає їх у стабільному JSON, тож вам не потрібно підтримувати власний парсер.
Чи можна знайти авто Copart за VIN?
Так. Шукайте за VIN, і ви отримаєте авто з його лотами, зокрема з попередніми продажами, якщо його вже виставляли.
Чи отримаю я фото?
Так. Кожен лот має свою галерею в кількох розмірах, а також відео й огляд 360°, якщо вони є на Copart.
Чи можна робити ставки через API?
Ні. API лише повертає дані. Ставки робляться на Copart, через ваш власний акаунт або брокера.
Як спробувати?
Запросіть безкоштовний демо-ключ. Він повертає реальні дані в тому самому JSON, що й платні тарифи.

Куди далі?

Готові спробувати?

05/ 05Наступний крок

Подивіться на лоти Copart у власному коді

Розкажіть, що ви створюєте. Ми відповімо письмово, надішлемо демо-ключ і опишемо наступні кроки.

Telegram
Отримати безкоштовний демо-ключ

Copart – торговельна марка її власника. MotorAPIs – незалежний сервіс, не пов’язаний із Copart і не схвалений нею.