Посібник
Синтаксис фільтрів пошуку
Фільтри — це параметри запиту у форматі 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 див. у розділі Значення enum.
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"