Справочник API / Автомобили
Поиск автомобилей на активных аукционах
/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.
- Измените значения ниже
- Запрос справа обновитсяЗапрос выше обновится
- Запустите live со своим ключом
Query-параметры 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.