Podłącz klucz
GET/carsEksport

Eksportuj pojazdy za pomocą kursora

Strumieniuj wszystkie aktywne samochody z Twoich źródeł, z pełnymi raportami, przez kursor po stronie serwera. Stworzone do synchronizowania lokalnej kopii.

  • 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.
  • 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.
  • 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[].
  • Ustaw is_auction w pierwszym żądaniu: next_url i scroll_id zachowują wartość, także false. Zmiana filtra lub jawna wartość bez zapisanego stanu zwraca 422.
  • Zacznij bez scroll_id, a potem żądaj każdego next_url bez zmian, aż scroll_id będzie null. Zobacz przewodnik po synchronizacji.
  • limit wynosi 1–500 (domyślnie 500). scroll_time wynosi 1–15 minut (domyślnie 10).
  • Nie zmieniaj domains[] i is_leasing przez cały przebieg. Ich zmiana zwraca 422.
  • total może być null, jeśli jego wpis w cache został utracony.

Parametry zapytania

16
limitinteger1–500 · default 500

Liczba elementów w partii. Domyślnie 500; maksimum 500. Użyteczny eksport wymaga wartości dodatnich.

scroll_timeinteger1–15 · default 10

Czas życia kursora w minutach. Domyślnie 10, maksimum 15.

scroll_idstring

Nieprzezroczysty kursor z poprzedniej odpowiedzi. Zalecane jest podążanie za next_url.

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.

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.

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.

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.

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

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][0][generations][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][0][generations][0][variants][]integer[]≥ 1 · ≤ 100 items

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][0][generations][0][trims][]integer[]≥ 1 · ≤ 100 items

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.

langstring

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

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 · Partia pełnych obiektów Car w data, z next_url, scroll_id i total. Ostatnia strona ma scroll_id: null, puste data i message: "No more data".
GET/cars
curl -g "https://api.auctionsapi.com/cars?limit=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"
PrzykładyNagrane
{4 keys
"data": [1 item
0: {20 keys
"id": "290nw54Bkl-iPxZqEe_N"
"has_inspections": false
"has_history_reports": false
"year": 2007
"vin": "kmhdu46d27u158653"
"brand": {2 keys}
"model": {2 keys}
"engine_volume": 2000
"cylinders": 4
"body_type": {2 keys}
"fuel": {2 keys}
"color": {2 keys}
"power_hp": 138
"market_origin": {2 keys}
"drive_wheels": {2 keys}
"option_ids": []
"listings": [1 item]
"inspections": []
"vehicle_history_reports": []
"hash": "473326c69c007f50506c0cffdf30b08cf28e978d9ff2d5e7dca0dc75a54a3f6c"
}
]
"next_url": "https://api.carstat.dev/cars?scroll_id=FGluY2x1ZGVfY29udGV4dF91…&lang=en&api_key=YOUR_API_KEY&limit=2"
"scroll_id": "FGluY2x1ZGVfY29udGV4dF91…"
"total": 3217391
}

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