Przewodnik

Składnia filtrów wyszukiwania

Filtry to parametry zapytania w formacie nawiasów PHP. Te same filtry działają w /search i /search/count; /cars przyjmuje domains[] i is_leasing.

Rodzaj	Składnia
Lista ID	`fuels[]=2&fuels[]=3` — powtarzaj klucz; przecinki nie są rozdzielane
Marka + modele	`brands[0][id]=88&brands[0][models][]=573`
Kilka marek	`brands[0][id]=88&brands[1][id]=13`
Zakres	`year_from=2018&year_to=2022` — oba końce włącznie
Flaga	`has_inspections=1` — wysyłaj `1` lub `0`; `true` zwraca 422
Leasing	`is_leasing=0` — pasuje też do ogłoszeń bez flagi
Cena	`price_from=10000&currency=eur` — filtruje w tej walucie
Lokalizacja	`countries[0][id]=208&countries[0][regions][]=1841610`

Filtry kategorii przyjmują liczbowe ID. Wszystkie ID znajdziesz w Wartościach enum.
currency wpływa tylko na filtrowanie i sortowanie po cenie. Ceny ogłoszeń są zawsze zwracane w oryginalnej walucie.
Dla dokładnego VIN użyj /cars/vin/{vin}. Filtr vin w /search dopasowuje częściowo.
Pomijaj filtry, których nie używasz. Puste wartości są walidowane i mogą zwrócić 422.

Wyszukiwanie z filtrami

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&currency=eur&has_inspections=1&sort=newest&perPage=20&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"