Руководства

Синтаксис фильтров поиска

Фильтры передаются в query-строке /cars. Все они необязательны и объединяются через AND.

Не указывайте лишние фильтры

Никогда не отправляйте пустое значение, например domain_id= или page=. Просто не указывайте параметр.

Источник и автомобиль

domain_id=3 – это Copart, а domain_id=1 – IAAI. Параметр выбирает автомобили с подходящим объявлением; их вложенные lots могут включать другие источники, поэтому читайте lots[].domain.id.

Несколько производителей

manufacturer_id принимает одну строку с ID через запятую, например 16,20. Не отправляйте массив.

Несколько статусов

Используйте повторяющиеся ключи со скобками: status[]=4&status[]=5. Не сочетайте status и status[] и никогда не отправляйте status=[].

Поиск по VIN

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

Годы

year – точное значение; from_year и to_year – границы включительно. В /cars они применяются вместе.

Даты аукциона

sale_date_from и sale_date_to – календарные даты без границ (YYYY-MM-DD). sale_date_from переопределяет sale_date_in_days, а without_sale_date=1 переопределяет все три.

Недавно изменённые

minutes=60 возвращает автомобили, обновлённые за последний час. Поддерживаемый диапазон – 1–4320 минут (72 часа).

Цены и пробег

buy_now_price_* и bid_price_* используют сохранённые единицы цены источника без конвертации и сборов. Если заданы границы и в километрах, и в милях, должны совпасть обе.

Текстовые фильтры

name, engine_name, damage и document_title – подстроки без учёта регистра. Если damage или document_title ничего не находит в своём справочнике, фильтр не применяется.