GET/searchPojazdy

Wyszukaj 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ść.

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.
is_auction przyjmuje true/false/1/0. False obejmuje false, null i brak flagi; pominięcie parametru wyłącza filtr. Musi pasować razem z is_leasing do jednego aktywnego ogłoszenia dozwolonej domeny; inne ogłoszenia mogą pozostać w listings[].
perPage wynosi 2–50 (domyślnie 50). perPage=1 zwraca 422.
Utrzymuj page × perPage na poziomie najwyżej 10 000. Aby czytać dalej, użyj /cars.
data może zawierać perPage + 1 samochodów, a meta.total zatrzymuje się na 10 000. Dokładne sumy uzyskasz z /search/count.
sort=auction_nearest wybiera nadchodzące aukcje: auction_at >= now w aktywnym ogłoszeniu wybranej domeny. Podaj ten sam sort do /search/count.
Sortowanie po cenie (cheaper, expensive) porównuje ceny w currency.
Używaj price dla Buy Now, current_bid dla bieżącej oferty, a /listing-fields dla dostępnych dodatkowych kwot. Porównania kwot wymagają waluty źródłowej w każdym warunku custom-field; kwoty źródła nie są przeliczane.

Parametry zapytania

Zapytanie, stronicowanie i zakres

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

Sort order. Price sorting requires a resolved currency. auction_nearest selects only cars with an active listing in an enabled/selected domain with auction_at >= now; past dates do not participate in sorting. Pass the same sort to /search/count for a matching count.

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.

vehicle_typestringdefault automobile

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.

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

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.

brands[0][models][]integer[]≥ 1 · ≤ 100 items

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.

brands[0][models][0][id]integer≥ 1

brands[0][models][0][generations][0][id]integer≥ 1

brands[0][models][0][generations][0][variants][]integer[]≥ 1 · ≤ 100 items

brands[0][models][0][generations][0][trims][]integer[]≥ 1 · ≤ 100 items

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.

is_auctionboolean

Optional auction filter. Send true (or 1) for listings explicitly marked is_auction=true. Send false (or 0) to exclude true, including stored false, null and missing fields. Omit for no auction filter; empty or invalid values return 422. Combined is_auction and is_leasing must match the same listing. A car must have at least one matching active listing in the enabled/selected domain scope. Other listings can remain in the response, so cars with mixed listing types can match both values. For /cars, set this on the first request and follow next_url unchanged; false is preserved. Continuing with only scroll_id retains the filter. Changing or adding the filter mid-scroll returns 422. If cached filter state is lost or the scroll predates this parameter, an explicit value returns 422; start a new scroll.

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.

interior_colors[]integer[]≤ 100 items

ID kolorów wnętrza ze słownika kolorów. Wartości listy łączy LUB; brakujące wartości nie pasują. Dotyczy /search, /search/count i /cars. Nie zmieniaj podczas kontynuowania scroll.

cylinders[]integer[]1–99 · ≤ 99 items

Dokładna liczba cylindrów (1–99), LUB w obrębie listy; nieznane wartości nie pasują. Dotyczy /search, /search/count i /cars. Nie zmieniaj podczas kontynuowania scroll.

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

Dodatkowe pola ogłoszeń

Połącz klucz, aby zobaczyć pola dostępnych domen.

Zwraca · Strona obiektów Car w data, z links i meta. Tablice inspections i vehicle_history_reports są pomijane.

GET/search

curl -g "https://api.auctionsapi.com/search?perPage=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

PrzykładyNagrane

{3 keys

"data": [1 item

0: {21 keys

"id": "l_eCJb-8zB_XcJ-z6Y7oZWjw"

"has_inspections": true

"has_history_reports": true

"year": 2014

"month": 4

"vin": "wddhf0cb3ea952710"

"brand": {2 keys

}

"model": {2 keys

}

"engine_volume": 2143

"seats": 5

"body_type": {2 keys

}

"transmission": {2 keys

}

"transmission_steps": 6

"fuel": {2 keys

}

"color": {2 keys

}

"power_hp": 170

"market_origin": {2 keys

}

"badge": "E220 CDI Avantgarde"

"option_ids": [53 items

]

"listings": [1 item

]

"hash": "093563801f92d9cfa23a07346b26b69db32df8da05d7c5ee60fa5fd876a7fe0b"

}

]

"links": {4 keys

}

"meta": {7 keys

}

Uzyskaj dostęp do API

Podłącz klucz, aby uruchamiać każde zapytanie z tych stron na własnych danych. Nie masz jeszcze klucza? Poproś nas o klucz demo: ten sam JSON co w planach płatnych.

Mam już klucz