УкраїнськаДовідник API / Авто
Пошук авто на активних аукціонах
/carsРозмір сторінки 50 / 1000Пошук авто з активними лістингами Copart або IAAI. Підходить для підбору, інвентарю імпортерів, моніторингу та аналізу ринку.
- Фільтруйте за джерелом, виробником, моделлю, поколінням, роком, пробігом, ціною, локацією, пошкодженням і деталями аукціону. Усі параметри запиту необов’язкові.
- Розмір сторінки за замовчуванням – 50 на кожному плані; максимум – 1000 на Unlimited. Авто впорядковано за внутрішнім ID, за замовчуванням за зростанням. Використовуйте minutes для оновлень за останні 4320 хвилин (72 години), а
/archived-lots– для відстеження видалених лістингів. - Повертає авто в data, а пагінацію – в links і meta. Кожне авто містить характеристики та масив lots з ідентифікаторами джерел, фото, пробігом, цінами, датами аукціонів і станом, якщо вони доступні. Додайте
prices_history=1,щоб включити масив prices кожного лота. - Активний лістинг не гарантує, що торги відкриті. Про поточне обмеження реалізації див.
exclude_expired_auctions.
- Змініть значення нижче
- Запит праворуч оновитьсяЗапит вище оновиться
- Запустіть live зі своїм ключем
Параметри запиту 46
ID платформи-джерела: 1 = IAAI, 3 = Copart. Пропустіть, щоб шукати в усіх джерелах, доступних вашому акаунту. Фільтрує відповідні авто; їхні вкладені lots можуть містити й інші джерела.
Авто або лістинги, оновлені за останні N хвилин. Використовуйте 1–4320 (до 72 годин), наприклад 60. Пропустіть для звичайного фіду.
Кількість записів на сторінку. Пропустіть для 50. Максимум 1000 на Unlimited; Demo та Small обмежені 50.
Номер сторінки, починаючи з 1. Пропустіть, щоб запросити сторінку 1.
Установіть 1, щоб пропустити загальні кількості, або 0, щоб включити їх. Пропустіть, щоб використати типове значення вашого акаунта. Проста пагінація підходить для великих синхронізацій.
Впорядкування авто за внутрішнім ID: asc (за замовчуванням) або desc. Не сортує за часом аукціону чи ціною.
Установіть 1, щоб включити масив історії цін кожного лота. Пропустіть або використайте 0 для стандартної відповіді.
Один ID виробника або ID через кому з /manufacturers/{type}, наприклад 16 (BMW) або 16,20. Надсилайте один рядок, а не масив.
Внутрішній ID моделі з /models/{manufacturer_id}/{type}.
Внутрішній ID покоління з /generations/{model_id}/{type}.
Точний модельний рік, наприклад 2020. У /cars застосовується разом з будь-яким діапазоном років.
Мінімальний модельний рік включно. Можна поєднувати з to_year.
Максимальний модельний рік включно. Можна поєднувати з from_year.
VIN (збіг зі збереженим значенням без урахування регістру) або номер лота в джерелі. Для фільтра лише за VIN використовуйте vin; для пошуку серед активних і архівних – /search-vin або /search-lot.
Фільтр за VIN без урахування регістру. Використовуйте _ як шаблон для кількох символів: YV1MC_ збігається з VIN, що починаються з YV1MC. Без шаблону збігається з повним збереженим значенням.
Підрядок назви авто без урахування регістру, наприклад Corvette.
ID категорії авто. Див. допустимі значення нижче.
ID типу кузова. Див. допустимі значення нижче.
ID зовнішнього кольору. Див. допустимі значення нижче.
ID типу пального. Див. допустимі значення нижче.
ID коробки передач: 1 = автоматична, 2 = механічна.
ID приводу: 1 = задній, 2 = передній, 3 = повний.
ID стану лістингу. Див. допустимі значення нижче.
Точна кількість циліндрів двигуна, наприклад 4, 6 або 8.
Підрядок назви двигуна без урахування регістру, наприклад 2.0.
Дволітерний код країни розташування авто, наприклад US або CA. Пропустіть, щоб включити всі доступні країни.
Код штату або провінції з /usa/states, наприклад CA або FL. Без урахування регістру; поєднуйте з country, щоб розрізнити локації з однаковим кодом.
Підрядок назви основного або вторинного пошкодження з /usa/damages без урахування регістру, наприклад hail або front. Надсилайте скалярний рядок. Якщо жодне пошкодження з довідника не збігається, фільтр не застосовується.
Підрядок назви документа (title) з /usa/titles без урахування регістру, наприклад salvage. Перевіряє title лістингу, детальний і короткий title. Якщо жоден title з довідника не збігається, фільтр не застосовується.
ID статусу аукціону. Див. допустимі значення нижче. Для кількох статусів використовуйте status[] замість нього; не надсилайте обидва.
Кілька ID статусів аукціону (1–10) як повторювані ключі з дужками, наприклад status[]=4&status[]=5. Використовуйте замість status. Не надсилайте status=[] чи рядок JSON.
Установіть 1, щоб вимагати додатну ціну Buy Now. 0 або пропуск залишає Buy Now без фільтра.
Мінімальна ціна Buy Now включно (1 або більше, десяткові приймаються). Суми задано у збережених одиницях ціни джерела, без конвертації та зборів.
Максимальна ціна Buy Now включно (1 або більше, десяткові приймаються). Суми задано у збережених одиницях ціни джерела, без конвертації та зборів.
Мінімальна збережена ставка включно (1 або більше, десяткові приймаються). Це не сума остаточного продажу.
Максимальна збережена ставка включно (1 або більше, десяткові приймаються). Це не сума остаточного продажу.
Мінімальний зафіксований пробіг у кілометрах включно. Якщо задано і кілометровий, і мильний фільтри, мають збігатися обидва.
Максимальний зафіксований пробіг у кілометрах включно. Якщо задано і кілометровий, і мильний фільтри, мають збігатися обидва.
Мінімальний зафіксований пробіг у милях включно. Якщо задано і кілометровий, і мильний фільтри, мають збігатися обидва.
Максимальний зафіксований пробіг у милях включно. Якщо задано і кілометровий, і мильний фільтри, мають збігатися обидва.
Дата аукціону строго після цієї календарної дати (YYYY-MM-DD). Час ігнорується. Перевизначає sale_date_in_days; ігнорується з without_sale_date=1.
Дата аукціону строго до цієї календарної дати (YYYY-MM-DD). Час ігнорується. Ігнорується з without_sale_date=1.
Лоти, дата аукціону яких пізніша, ніж N днів тому, включно з майбутніми датами. Перевизначається sale_date_from; ігнорується з without_sale_date=1.
Часові позначки аукціону між зараз і N годинами від зараз включно, наприклад 24. Поєднується з іншими ввімкненими фільтрами дат.
Установіть 1, щоб вибрати лоти без дати продажу. Перевизначає sale_date_from, sale_date_to і sale_date_in_days.
Поточне обмеження реалізації: попри назву, 1 вибирає лоти без дати продажу або з датою продажу раніше за поточний момент, тож минулі аукціони не виключаються. Пропустіть його або використайте 0; для вікна найближчих аукціонів використовуйте next_hours_auction.