GET/search/countPojazdy

Policz pasujące pojazdy

Policz samochody pasujące do zestawu filtrów. Przyjmuje wszystkie filtry /search; paginacja i sortowanie są ignorowane.

Wartość dokładna, w przeciwieństwie do meta.total w /search, które zatrzymuje się na 10 000.
Brak wyników zwraca {"count": 0} ze statusem 200.

Parametry zapytania

Zapytanie, stronicowanie i zakres

querystring≤ 200 chars

Pełnotekstowe wyszukiwanie pojazdów. Pomijaj nieużywane filtry.

vinstring1–19 chars

Częś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 1

Numer strony. W /search jawnie przekazuj perPage i utrzymuj page × perPage ≤ 10000. /search/count ignoruje paginację i pomija to sprawdzenie przesunięcia.

perPageinteger2–50 · default 50

Rozmiar 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.

sortstring

Kolejność sortowania. Sortowanie po cenie wymaga rozpoznanej waluty.

currencystring3 chars · default usd

Kod 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≥ 1

Opcjonalne wewnętrzne ID waluty; nadpisuje currency.

domains[]integer[]≥ 1

Opcjonalny 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.

langstring

Język odpowiedzi. Tłumaczenia opcji są dodatkowo ograniczone do języków konta. Strona automatycznie wybiera bieżący język.

Marka, model i lokalizacja

brands[0][id]integer

ID 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]integer

Pierwsze 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.

Zakresy

seatsinteger1–200

Dokładna liczba miejsc.

price_fromint64≥ 0

Minimalna 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≥ 1

Maksymalna 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,000

Minimalny rok produkcji.

year_tointeger1,800–3,000

Maksymalny rok produkcji.

odometer_frominteger0–999,999,999

Minimalny przebieg w kilometrach.

odometer_tointeger0–999,999,999

Maksymalny przebieg w kilometrach.

engine_volume_frominteger0–999,999,999

Minimalna pojemność silnika.

engine_volume_tointeger0–999,999,999

Maksymalna pojemność silnika.

power_hp_frominteger0–100,000

Minimalna moc w koniach mechanicznych.

power_hp_tointeger1–100,000

Maksymalna moc w koniach mechanicznych.

Flagi

is_leasingboolean

Opcjonalny 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_availableinteger

Ogł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_certifiedinteger

Ogł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_inspectionsinteger

Samochó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_reportsinteger

Ogł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.

Kategorie

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.

Zwraca · {"count": integer}

GET/search/count

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

PrzykładyNagrane

{1 key

"count": 3217391

}