Справка

Журнал изменений

Изменения публичного API. Все они только добавляют новое, если не указано иное, поэтому существующие интеграции продолжают работать.

Фильтр по типу транспорта и конфигурации

vehicle_type=automobile / 1 — по умолчанию; motorcycle / 2 выбирает мотоциклы в /search, /search/count и /cars. В справочниках используйте тот же тип.

Полная вложенность: brands[] → models[] → generations[] → variants[] / trims[]. У каждого объекта бренда, модели и поколения обязателен id. Между соседями и значениями в списках variants/trims — ИЛИ; между условиями одной ветки — И. Отсутствующий или пустой дочерний список означает любых потомков. В каждом массиве до 100 элементов. Неизвестные или несовместимые ID дают пустой результат; неверный формат — 422.

Справочники автомобилей и мотоциклов

/generations/{model_id} · /trims/{generation_id} · /variants/{generation_id}

Без vehicle_type возвращаются автомобили; motorcycle / 2 выбирает мотоциклы. Сохраняйте тип на каждом шаге. Без пагинации /brands и /models сохраняют прежние массивы и лимиты. Передайте per_page=100 для {data,meta}. Вложенные generations сохраняют {name,from,to}; ID поколений берите из /generations/{model_id}.

Более устойчивые проверки ключа и экспорт

Если сервис ключей ненадолго недоступен, запросы возвращают 503 с Retry-After: 5 вместо сбоя. Проход /cars теперь всегда завершается с scroll_id: null.

Детали местоположения и справочники

У каждого объявления теперь есть location_details с локализованными страной, регионом, районом и населённым пунктом. Новые эндпоинты /countries, /countries/{id}, /locations и /locations/{id}. next_url теперь использует HTTPS на том хосте, к которому вы обращались. Фильтр steering_wheel_position проходит валидацию.

Фильтр лизинга

is_leasing в /search, /search/count и /cars. /models/{brand_id} теперь возвращает 422 для нецелого ID марки. /search по умолчанию использует perPage=50.

Переводы отчётов

Отчёты об осмотре и истории содержат translations.terms с подписями для каждого стандартизированного ключа на запрошенном языке lang.

Данные источника в объявлениях

Объявления могут содержать source_data — собственные поля источника, переданные без изменений.

Единообразные поля /domains

/domains возвращает id, name и base_url для каждого источника.

Поиск по VIN

Новый эндпоинт /cars/vin/{vin} для поиска по точному VIN.

Отчёты об истории автомобиля

vehicle_history_reports на детальных эндпоинтах, а также has_history_reports у автомобилей и объявлений.

Осмотры и точные подсчёты

inspections и has_inspections, а также новый эндпоинт /search/count.

Получите доступ к API

Подключите ключ, чтобы выполнять любой запрос с этих страниц на своих данных. Ключа ещё нет? Попросите у нас демо-ключ: тот же JSON, что и в платных тарифах.

У меня есть ключ