Перейти к содержимому

Справочник API / Автомобили

Поиск автомобилей на активных аукционах

GET/carsРазмер страницы 50 / 1000

Поиск автомобилей с активными объявлениями Copart или IAAI. Подходит для подбора, инвентаря импортёров, мониторинга и анализа рынка.

  • Фильтруйте по источнику, производителю, модели, поколению, году, пробегу, цене, местоположению, повреждениям и данным аукциона. Все query-параметры необязательны.
  • Размер страницы по умолчанию – 50 на любом тарифе; максимум – 1000 на Unlimited. Автомобили упорядочены по внутреннему ID, по умолчанию по возрастанию. Используйте minutes для обновлений за последние 4320 минут (72 часа), а /archived-lots – для отслеживания удалений.
  • Возвращает автомобили в data, а пагинацию в links и meta. Каждый автомобиль содержит характеристики и массив lots с идентификаторами источника, фото, пробегом, ценами, датами аукциона и состоянием, если они доступны. Добавьте prices_history=1, чтобы включить массив prices каждого лота.
  • Активное объявление не гарантирует, что торги открыты. О текущем ограничении реализации см. exclude_expired_auctions.
  1. Измените значения ниже
  2. Запрос справа обновитсяЗапрос выше обновится
  3. Запустите live со своим ключом

Query-параметры 46

integer

ID платформы-источника: 1 = IAAI, 3 = Copart. Не указывайте, чтобы искать по всем источникам, доступным вашему аккаунту. Фильтрует подходящие автомобили; их вложенные lots могут включать и другие источники.

integer · 1–4320

Автомобили или объявления, обновлённые за последние N минут. Используйте 1–4320 (до 72 часов), например 60. Не указывайте для обычной ленты.

integer · 1–1000

Количество записей на страницу. Без параметра – 50. Максимум 1000 на Unlimited; Demo и Small ограничены 50.

integer · 1+

Номер страницы, начиная с 1. Не указывайте, чтобы получить страницу 1.

integer · 0–1

Укажите 1, чтобы не считать общее количество, или 0, чтобы включить его. Без параметра используется значение по умолчанию вашего аккаунта. Простая пагинация подходит для крупных синхронизаций.

string

Порядок автомобилей по внутреннему ID: asc (по умолчанию) или desc. Сортировки по времени аукциона или цене нет.

integer · 0–1

Укажите 1, чтобы включить массив истории цен для каждого лота. Не указывайте или используйте 0 для стандартного ответа.

string

Один ID производителя или ID через запятую из /manufacturers/{type}, например 16 (BMW) или 16,20. Отправляйте одну строку, а не массив.

integer · 1+

Внутренний ID модели из /models/{manufacturer_id}/{type}.

integer · 1+

Внутренний ID поколения из /generations/{model_id}/{type}.

integer

Точный модельный год, например 2020. В /cars применяется вместе с любым диапазоном лет.

integer

Минимальный модельный год, включительно. Можно сочетать с to_year.

integer

Максимальный модельный год, включительно. Можно сочетать с from_year.

string

VIN (совпадение с сохранённым значением без учёта регистра) или номер лота источника. Для фильтра только по VIN используйте vin; для поиска по активным и архивным объявлениям – /search-vin или /search-lot.

string

Фильтр по VIN без учёта регистра. Используйте _ как маску для любого количества символов: YV1MC_ совпадает с VIN, начинающимися с YV1MC. Без маски совпадает с полным сохранённым значением.

string

Подстрока названия автомобиля без учёта регистра, например Corvette.

integer

ID категории автомобиля. См. допустимые значения ниже.

integer

ID типа кузова. См. допустимые значения ниже.

integer

ID цвета кузова. См. допустимые значения ниже.

integer

ID типа топлива. См. допустимые значения ниже.

integer

ID коробки передач: 1 = автомат, 2 = механика.

integer

ID привода: 1 = задний, 2 = передний, 3 = полный.

integer

ID состояния объявления. См. допустимые значения ниже.

integer

Точное количество цилиндров двигателя, например 4, 6 или 8.

string

Подстрока названия двигателя без учёта регистра, например 2.0.

string

Двухбуквенный код страны местоположения автомобиля, например US или CA. Не указывайте, чтобы включить все доступные страны.

string

Код штата или провинции из /usa/states, например CA или FL. Без учёта регистра; сочетайте с country, чтобы различать местоположения с одинаковым кодом.

string

Подстрока названия основного или вторичного повреждения из /usa/damages без учёта регистра, например hail или front. Отправляйте скалярную строку. Если в справочнике нет подходящего повреждения, фильтр не применяется.

string

Подстрока названия документа (title) из /usa/titles без учёта регистра, например salvage. Проверяются title объявления, подробный и краткий title. Если в справочнике нет подходящего title, фильтр не применяется.

integer

ID статуса аукциона. См. допустимые значения ниже. Для нескольких статусов используйте status[] вместо этого параметра; не отправляйте оба.

array of integers

Несколько ID статусов аукциона (1–10) в виде повторяющихся ключей со скобками, например status[]=4&status[]=5. Используйте вместо status. Не отправляйте status=[] или JSON-строку.

integer · 0–1

Укажите 1, чтобы требовать положительную цену Buy Now. 0 или отсутствие параметра не фильтрует по Buy Now.

number · 1+

Минимальная цена Buy Now, включительно (1 или больше, допускаются десятичные). Суммы указаны в сохранённых единицах цены источника, без конвертации и сборов.

number · 1+

Максимальная цена Buy Now, включительно (1 или больше, допускаются десятичные). Суммы указаны в сохранённых единицах цены источника, без конвертации и сборов.

number · 1+

Минимальная сохранённая ставка, включительно (1 или больше, допускаются десятичные). Это не сумма итоговой продажи.

number · 1+

Максимальная сохранённая ставка, включительно (1 или больше, допускаются десятичные). Это не сумма итоговой продажи.

integer · 1+

Минимальный зафиксированный пробег в километрах, включительно. Если заданы фильтры и по километрам, и по милям, должны совпасть оба.

integer · 1+

Максимальный зафиксированный пробег в километрах, включительно. Если заданы фильтры и по километрам, и по милям, должны совпасть оба.

integer · 1+

Минимальный зафиксированный пробег в милях, включительно. Если заданы фильтры и по километрам, и по милям, должны совпасть оба.

integer · 1+

Максимальный зафиксированный пробег в милях, включительно. Если заданы фильтры и по километрам, и по милям, должны совпасть оба.

string (date)

Дата аукциона строго после этой календарной даты (YYYY-MM-DD). Время игнорируется. Переопределяет sale_date_in_days; игнорируется при without_sale_date=1.

string (date)

Дата аукциона строго до этой календарной даты (YYYY-MM-DD). Время игнорируется. Игнорируется при without_sale_date=1.

integer · 1+

Лоты, дата аукциона которых позже, чем N дней назад, включая будущие даты. Переопределяется sale_date_from; игнорируется при without_sale_date=1.

integer · 1+

Время аукциона между текущим моментом и N часами вперёд, включительно, например 24. Сочетается с другими включёнными фильтрами по датам.

integer · 0–1

Укажите 1, чтобы выбрать лоты без даты продажи. Переопределяет sale_date_from, sale_date_to и sale_date_in_days.

integer · 0–1

Текущее ограничение реализации: несмотря на название, 1 выбирает лоты без даты продажи или с датой продажи раньше текущего момента, то есть прошедшие аукционы не исключаются. Не указывайте параметр или используйте 0; для окна предстоящих аукционов используйте next_hours_auction.

© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.