Руководство
Синтаксис фильтров поиска
Фильтры — это параметры запроса в формате PHP с квадратными скобками. Одни и те же фильтры работают в /search и /search/count; /cars принимает domains[] и is_leasing.
| Тип | Синтаксис |
|---|---|
| Список ID | fuels[]=2&fuels[]=3 — повторяйте ключ; значения через запятую не разделяются |
| Марка + модели | brands[0][id]=88&brands[0][models][]=573 |
| Несколько марок | brands[0][id]=88&brands[1][id]=13 |
| Диапазон | year_from=2018&year_to=2022 — обе границы включительно |
| Флаг | has_inspections=1 — передавайте 1 или 0; true возвращает 422 |
| Лизинг | is_leasing=0 — также находит объявления без флага |
| Цена | price_from=10000¤cy=eur — фильтрует в указанной валюте |
| Местоположение | countries[0][id]=208&countries[0][regions][]=1841610 |
- Категориальные фильтры принимают числовые ID. Все ID см. в разделе Значения перечислений.
currencyвлияет только на фильтрацию и сортировку по цене. Цены объявлений всегда возвращаются в исходной валюте.- Для точного VIN используйте
/cars/vin/{vin}. Фильтрvinв/searchищет частичное совпадение. - Не передавайте фильтры, которые не используете. Пустые значения проходят валидацию и могут вернуть 422.
Поиск с фильтрами
curl -g "https://api.lotarius.com/search?brands[0][id]=88&brands[0][models][]=573&year_from=2018&fuels[]=1&fuels[]=3&price_to=30000¤cy=eur&has_inspections=1&sort=newest&perPage=20&api_key=$CARS_API_KEY" \
-H "Accept: application/json"