GET/searchАвтомобили

Поиск автомобилей

Фильтрация активных автомобилей по всем включённым источникам. Результаты облегчённые: у каждого автомобиля есть флаги отчётов, но не сами отчёты.

perPage — от 2 до 50 (по умолчанию 50). perPage=1 возвращает 422.
Держите page × perPage не выше 10,000. Чтобы читать дальше, используйте /cars.
data может содержать perPage + 1 автомобилей, а meta.total ограничен 10,000. Для точного количества используйте /search/count.
Сортировки по цене (cheaper, expensive) сравнивают цены в currency.

Параметры запроса

Запрос, страницы и охват

querystring≤ 200 chars

Полнотекстовый поиск автомобилей. Не передавайте неиспользуемые фильтры.

vinstring1–19 chars

Частичный VIN без учёта регистра. Для точного VIN из 16–19 символов используйте /cars/vin/{vin}.

pageinteger≥ 1 · default 1

Номер страницы. Для /search явно передавайте perPage и соблюдайте page × perPage ≤ 10000. /search/count игнорирует пагинацию и пропускает эту проверку смещения.

perPageinteger2–50 · default 50

Размер страницы поиска: минимум 2, максимум 50. perPage=1 возвращает 422; для небольшой выборки используйте perPage=2. Если значения пагинации не переданы или равны null, используются page=1 и perPage=50, в том числе при проверке окна результатов поиска. Недопустимые значения возвращают 422.

sortstring

Порядок сортировки. Для сортировки по цене нужна определённая валюта.

currencystring3 chars · default usd

Код валюты без учёта регистра для фильтрации/сортировки по цене. Должен существовать в справочнике валют. Не конвертирует цены объявлений в ответе.

currency_idinteger≥ 1

Необязательный внутренний ID валюты; имеет приоритет над currency.

domains[]integer[]≥ 1

Необязательный набор источников. Используйте ID, возвращаемые GET /domains. Если не указан, используются все включённые домены. Повторяйте параметр со скобками: domains[]=33&domains[]=34. Каждый ID должен быть включён для этого ключа.

langstring

Локаль ответа. Переводы опций также ограничены языками аккаунта. Страница автоматически подставляет текущий язык.

Марка, модель и местоположение

brands[0][id]integer

ID первой марки из /brands. Для дополнительных марок используйте brands[1][id] и т. д.

brands[0][models][]integer[]

Необязательные ID моделей для первой марки, возвращаемые /models/{brand_id}. Не передавайте, чтобы выбрать все модели.

countries[0][id]integer

Внутренний ID первой страны из /countries. Для дополнительных стран используйте countries[1][id] и т. д.

countries[0][regions][]integer[]

Необязательные внутренние ID регионов, относящихся к первой стране.

Диапазоны

seatsinteger1–200

Точное число посадочных мест.

price_fromint64≥ 0

Минимальная цена объявления в выбранной валюте. Максимум 9223372036854775807 (знаковое 64-битное целое); значения за пределами безопасных целых чисел JavaScript клиенты должны хранить как десятичный текст.

price_toint64≥ 1

Максимальная цена объявления в выбранной валюте. Максимум 9223372036854775807 (знаковое 64-битное целое); значения за пределами безопасных целых чисел JavaScript клиенты должны хранить как десятичный текст.

year_frominteger1,800–3,000

Минимальный год выпуска.

year_tointeger1,800–3,000

Максимальный год выпуска.

odometer_frominteger0–999,999,999

Минимальный пробег в километрах.

odometer_tointeger0–999,999,999

Максимальный пробег в километрах.

engine_volume_frominteger0–999,999,999

Минимальный объём двигателя.

engine_volume_tointeger0–999,999,999

Максимальный объём двигателя.

power_hp_frominteger0–100,000

Минимальная мощность в лошадиных силах.

power_hp_tointeger1–100,000

Максимальная мощность в лошадиных силах.

Флаги

is_leasingboolean

Необязательный фильтр лизинга. Передайте true (или 1) для объявлений, явно помеченных is_leasing=true. Передайте false (или 0), чтобы исключить true, включая сохранённые false, null и отсутствующие поля. Не передавайте, чтобы не фильтровать по лизингу; пустые или недопустимые значения возвращают 422. У автомобиля должно быть хотя бы одно подходящее активное объявление во включённом/выбранном наборе доменов. Другие объявления могут остаться в ответе, поэтому автомобили со смешанными типами объявлений могут соответствовать обоим значениям. Для /cars задайте его в первом запросе и следуйте next_url без изменений; false сохраняется. При продолжении только со scroll_id фильтр сохраняется. Изменение или добавление фильтра посреди прокрутки возвращает 422. Если сохранённое в кэше состояние фильтра утеряно или прокрутка начата до появления этого параметра, явное значение возвращает 422; начните новую прокрутку.

keys_availableinteger

У объявления есть ключи. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

is_manufacturer_certifiedinteger

Объявление сертифицировано производителем или официальной дилерской программой. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

has_inspectionsinteger

У корневого автомобиля есть публичный осмотр. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

has_history_reportsinteger

У объявления в выбранном наборе доменов есть публичный отчёт об истории. Передайте 1 (true) или 0 (false). Не передавайте, чтобы учитывать оба значения; строки "true"/"false" не принимаются.

Категории

body_types[]integer[]

Repeat to match any of the values.

colors[]integer[]

Repeat to match any of the values.

fuels[]integer[]

Repeat to match any of the values.

transmissioninteger

One value.

seller_typeinteger

One value.

steering_wheel_positioninteger

One value.

airbagsinteger

One value.

damages[]integer[]

Repeat to match any of the values.

conditions[]integer[]

Repeat to match any of the values.

availabilities[]integer[]

Repeat to match any of the values.

emissions[]integer[]

Repeat to match any of the values.

drive_wheels[]integer[]

Repeat to match any of the values.

Возвращает · Страница объектов Car в data, с links и meta. Массивы inspections и vehicle_history_reports не включаются.

GET/search

curl -g "https://api.lotarius.com/search?perPage=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

ПримерыЗаписано

{3 keys

"data": [1 item

0: {21 keys

"id": "l_eCJb-8zB_XcJ-z6Y7oZWjw"

"has_inspections": true

"has_history_reports": true

"year": 2014

"month": 4

"vin": "wddhf0cb3ea952710"

"brand": {2 keys

}

"model": {2 keys

}

"engine_volume": 2143

"seats": 5

"body_type": {2 keys

}

"transmission": {2 keys

}

"transmission_steps": 6

"fuel": {2 keys

}

"color": {2 keys

}

"power_hp": 170

"market_origin": {2 keys

}

"badge": "E220 CDI Avantgarde"

"option_ids": [53 items

]

"listings": [1 item

]

"hash": "093563801f92d9cfa23a07346b26b69db32df8da05d7c5ee60fa5fd876a7fe0b"

}

]

"links": {4 keys

}

"meta": {7 keys

}