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.

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

is_auction przyjmuje true, false, 1 lub 0 w /search, /search/count i /cars. False obejmuje false, null i brak pola. Pominięcie wyłącza filtr; puste lub nieprawidłowe wartości zwracają 422. is_auction i is_leasing muszą pasować do tego samego aktywnego ogłoszenia w dostępnym/wybranym źródle. Inne ogłoszenia mogą pozostać w listings[]. W /cars ustaw filtr w pierwszym żądaniu i podążaj za next_url bez zmian. Dodanie lub zmiana podczas scroll albo jawna wartość przy utracie stanu cache zwraca 422. sort=auction_nearest wymaga auction_at >= now; przekaż ten sam sort do /search/count.

Filtrowanie według typu i konfiguracji pojazdu

vehicle_type=automobile / 1 jest domyślne; motorcycle / 2 wybiera motocykle w /search, /search/count i /cars. Używaj tego samego typu w słownikach.

Pełne zagnieżdżenie: brands[] → models[] → generations[] → variants[] / trims[]. Każdy obiekt marki, modelu i generacji wymaga id. LUB między rodzeństwem i wartościami variants/trims; I między warunkami w jednej gałęzi. Brak lub pusta lista potomna oznacza wszystkich potomków. Do 100 elementów w tablicy. Nieznane lub niezgodne ID dają pusty wynik; zły format — 422.

Dotychczasowe brands[0][models][]=573 działa. Dla potomków użyj brands[0][models][0][id]=573. Wyczyść stare pole dodawania ID przed obiektami modeli tej marki, inaczej PHP nadpisze indeks 0.

vehicle_type=motorcycle&brands[0][id]=101&brands[0][models][0][id]=201&brands[0][models][0][generations][0][id]=301&brands[0][models][0][generations][0][variants][]=501&brands[0][models][0][generations][0][trims][]=401

ID są przykładowe: zastąp je wartościami ze słowników. Dla konkretnych par variant/trim używaj osobnych gałęzi generacji.

Odpowiedzi zawierają vehicle_type, generation_id, variant_id i trim_id; brakujące opcjonalne ID mają null. Pola uczestniczą w hash. Wyszukiwane są tylko zapisane ID samochodu: brak znormalizowanego ID oznacza brak zgodności z tym filtrem.

W /cars typ i cała hierarchia są stałe w ramach kursora. Podążaj za next_url bez zmian lub podawaj tylko scroll_id. Można zmienić kolejność równoważnych filtrów; nowe warunki lub jawne filtry bez zapisanego stanu zwracają 422. Zacznij nowy kursor. Stare kursory bez nowych parametrów zachowują swoje zapytanie.

Dodatkowe pola ogłoszeń

Pobierz /listing-fields po sprawdzeniu klucza. Definicje, ograniczenia, operatory i uwagi źródeł dotyczą tylko tego klucza i wybranych domen.

Tekst: eq, in, exists. Liczby i daty także gt, gte, lt, lte. Boolean: eq lub exists. Wybierz eq, in, exists albo zakres; exists osobno. Do 20 pól i 100 wartości w in.

Wszystkie warunki, domeny i aktywność muszą pasować do jednego ogłoszenia. Zero i false to wartości. W tablicy wystarczy pasujący element. Nieznane lub niedostępne pola/operatory zwracają 422.

Filtruj tylko pola filterable. Wartości indeksowane: listings[].custom_fields; pozostałe: listings[].source_data. Publikacja włącza filtry, kolejne zwykłe importy uzupełniają wartości. Bez uzupełniania starych dokumentów.

W /cars warunki obowiązują przez cały scroll. Niezgodna definicja lub utrata zapisanego stanu wymaga nowego scroll. Sortowanie i agregacje tych pól nie są obsługiwane.

Zastąp FIELD_KEY kluczem z dostępnego katalogu. Porównania pieniężne wymagają waluty ogłoszenia; przeliczanie Buy Now nie ma tu zastosowania.

Historyczne wyceny rynkowe źródła są informacyjnymi wartościami bez indeksowania. Opisują porównywalne transakcje, a nie cenę, ofertę lub cenę rezerwową danego ogłoszenia. Sprawdź opis pola, kryteria porównania i datę obliczenia; nie zakładaj waluty ogłoszenia. Zarejestrowane pola liczbowe mogą mieć wartość null, gdy wycena jest niedostępna.

custom_fields[FIELD_KEY][gte]=2
custom_fields[FIELD_KEY][in][]=a&custom_fields[FIELD_KEY][in][]=b
custom_fields[FIELD_KEY][eq]=false
custom_fields[FIELD_KEY][lte]=15000&custom_fields[FIELD_KEY][currency]=cad