/searchPojazdyWyszukaj pojazdy
Filtruj aktywne pojazdy we wszystkich włączonych źródłach. Wyniki są lekkie: każdy samochód zawiera flagi raportów, a nie ich treść.
perPagewynosi 2–50 (domyślnie 50).perPage=1zwraca 422.- Utrzymuj
page × perPagena poziomie najwyżej 10 000. Aby czytać dalej, użyj /cars. datamoże zawieraćperPage + 1samochodów, ameta.totalzatrzymuje się na 10 000. Dokładne sumy uzyskasz z /search/count.- Sortowanie po cenie (
cheaper,expensive) porównuje ceny wcurrency.
Parametry zapytania
41querystring≤ 200 charsPełnotekstowe wyszukiwanie pojazdów. Pomijaj nieużywane filtry.
vinstring1–19 charsCzęściowy VIN, bez rozróżniania wielkości liter. Dla dokładnego VIN o długości 16–19 znaków użyj /cars/vin/{vin}.
pageinteger≥ 1 · default 1Numer strony. W /search jawnie przekazuj perPage i utrzymuj page × perPage ≤ 10000. /search/count ignoruje paginację i pomija to sprawdzenie przesunięcia.
perPageinteger2–50 · default 50Rozmiar strony wyszukiwania: minimum 2, maksimum 50. perPage=1 zwraca 422; aby pobrać małą próbkę, użyj perPage=2. Pominięte lub null wartości paginacji oznaczają page=1 i perPage=50, także przy sprawdzaniu okna wyników wyszukiwania. Nieprawidłowe wartości zwracają 422.
sortstringKolejność sortowania. Sortowanie po cenie wymaga rozpoznanej waluty.
currencystring3 chars · default usdKod waluty (bez rozróżniania wielkości liter) do filtrowania/sortowania po cenie. Musi istnieć w słowniku walut. Nie przelicza zserializowanych cen ogłoszeń.
currency_idinteger≥ 1Opcjonalne wewnętrzne ID waluty; nadpisuje currency.
domains[]integer[]≥ 1Opcjonalny zakres źródeł. Używaj ID zwracanych przez GET /domains. Pomiń, aby użyć wszystkich włączonych domen. Powtarzaj parametr z nawiasami: domains[]=33&domains[]=34. Każde ID musi być włączone dla tego klucza.
langstringJęzyk odpowiedzi. Tłumaczenia opcji są dodatkowo ograniczone do języków konta. Strona automatycznie wybiera bieżący język.
brands[0][id]integerID pierwszej marki z /brands. Kolejne marki używają brands[1][id] itd.
brands[0][models][]integer[]Opcjonalne ID modeli dla pierwszej marki, zwracane przez /models/{brand_id}. Pomiń, aby uwzględnić wszystkie modele.
countries[0][id]integerPierwsze wewnętrzne ID kraju z /countries. Kolejne kraje używają countries[1][id] itd.
countries[0][regions][]integer[]Opcjonalne wewnętrzne ID regionów należących do pierwszego kraju.
seatsinteger1–200Dokładna liczba miejsc.
price_fromint64≥ 0Minimalna cena ogłoszenia w wybranej walucie. Maksimum 9223372036854775807 (64-bitowa liczba całkowita ze znakiem); wartości przekraczające bezpieczne liczby całkowite JavaScriptu klienci muszą zachowywać jako tekst dziesiętny.
price_toint64≥ 1Maksymalna cena ogłoszenia w wybranej walucie. Maksimum 9223372036854775807 (64-bitowa liczba całkowita ze znakiem); wartości przekraczające bezpieczne liczby całkowite JavaScriptu klienci muszą zachowywać jako tekst dziesiętny.
year_frominteger1,800–3,000Minimalny rok produkcji.
year_tointeger1,800–3,000Maksymalny rok produkcji.
odometer_frominteger0–999,999,999Minimalny przebieg w kilometrach.
odometer_tointeger0–999,999,999Maksymalny przebieg w kilometrach.
engine_volume_frominteger0–999,999,999Minimalna pojemność silnika.
engine_volume_tointeger0–999,999,999Maksymalna pojemność silnika.
power_hp_frominteger0–100,000Minimalna moc w koniach mechanicznych.
power_hp_tointeger1–100,000Maksymalna moc w koniach mechanicznych.
is_leasingbooleanOpcjonalny filtr leasingu. Wyślij true (lub 1) dla ogłoszeń jawnie oznaczonych is_leasing=true. Wyślij false (lub 0), aby wykluczyć true, w tym zapisane false, null i brakujące pola. Pomiń, aby nie filtrować po leasingu; puste lub nieprawidłowe wartości zwracają 422. Samochód musi mieć co najmniej jedno pasujące aktywne ogłoszenie we włączonym/wybranym zakresie domen. Inne ogłoszenia mogą pozostać w odpowiedzi, więc samochody z mieszanymi typami ogłoszeń mogą pasować do obu wartości. W /cars ustaw ten filtr w pierwszym żądaniu i podążaj za next_url bez zmian; false jest zachowywane. Kontynuacja z samym scroll_id zachowuje filtr. Zmiana lub dodanie filtra w trakcie przewijania zwraca 422. Jeśli zapisany w cache stan filtra został utracony lub przewijanie powstało przed wprowadzeniem tego parametru, jawna wartość zwraca 422; rozpocznij nowe przewijanie.
keys_availableintegerOgłoszenie ma kluczyki. Wyślij 1 (true) lub 0 (false). Pomiń, aby uwzględnić obie wartości; ciągi "true"/"false" są odrzucane.
is_manufacturer_certifiedintegerOgłoszenie jest certyfikowane w ramach programu producenta lub oficjalnego dealera. Wyślij 1 (true) lub 0 (false). Pomiń, aby uwzględnić obie wartości; ciągi "true"/"false" są odrzucane.
has_inspectionsintegerSamochód główny ma publiczną inspekcję. Wyślij 1 (true) lub 0 (false). Pomiń, aby uwzględnić obie wartości; ciągi "true"/"false" są odrzucane.
has_history_reportsintegerOgłoszenie w wybranym zakresie domen ma publiczny raport historii. Wyślij 1 (true) lub 0 (false). Pomiń, aby uwzględnić obie wartości; ciągi "true"/"false" są odrzucane.
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.
transmissionintegerOne value.
seller_typeintegerOne value.
steering_wheel_positionintegerOne value.
airbagsintegerOne 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.
data, z links i meta. Tablice inspections i vehicle_history_reports są pomijane./searchcurl -g "https://api.lotarius.com/search?perPage=5&api_key=$CARS_API_KEY" \
-H "Accept: application/json"