CarStat.dev
Obiekty

Obiekt ogłoszenia

Jedno ogłoszenie w jednym serwisie źródłowym. Tutaj znajdują się cena, przebieg, zdjęcia, lokalizacja i dane sprzedawcy. Ceny są podawane we własnej walucie ogłoszenia i nigdy nie są przeliczane.

externalobjectzawsze w odpowiedzi
Atrybuty podrzędne: 3
idstringzawsze w odpowiedzi

ID ogłoszenia w źródle; różni się od wewnętrznego ID samochodu.

domainobjectzawsze w odpowiedzi
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
urlstringzawsze w odpowiedzi
archivedbooleanzawsze w odpowiedzi
titlemap | []

Mapa język–tytuł, zwracana bez wybierania języka na podstawie lang. Klucze to kody locale (na przykład en lub ko); jako wartości zastępczej użyj dostępnego tłumaczenia. Zwraca null, gdy brak, lub [] dla pustej zapisanej mapy PHP.

odometernumbermoże być null
locationobject | []

Starszy obiekt lokalizacji lub [], gdy niedostępny. Używaj location_details dla jednolitego formatu ID/nazwa we wszystkich endpointach pojazdów. /search i /listing zwykle udostępniają zapisane ID; /cars, /cars/{car_id} i /cars/vin/{vin} próbują zastąpić country, location_admin_1, location_admin_2 i location_id lokalizowanymi nazwami, więc wartości mogą być ciągami lub nierozwiązanymi ID. Rozwiązuj liczbowe country przez /countries/{id}; liczbowe location_id, location_admin_1 i location_admin_2 rozwiązuj przez /locations/{id} lub zbiorczo za pomocą ids[]. Nie wysyłaj już zlokalizowanych nazw jako ID. Zobacz endpointy słownika lokalizacji.

Atrybuty podrzędne: 8
isostringmoże być null
postal_codestringmoże być null
countryinteger | string
location_admin_1integer | string
location_admin_2integer | string
location_idinteger | string
location_admin_3integer | string

Wartość administracyjna źródła; nie jest to gwarantowane ID słownika lokalizacji.

positionobject
Atrybuty podrzędne: 2
latnumber
lonnumber
location_detailsobjectzawsze w odpowiedzi

Zawsze obecne w każdym ogłoszeniu w /search, /cars, wyszukiwaniu po ID samochodu/VIN i wyszukiwaniu ogłoszeń. Wszędzie ten sam addytywny kształt; starsze location jest zachowane. country pochodzi z country_id, region z location_admin_1, district z location_admin_2, place z location_id. Każdy brakujący komponent ma wartość null. Znane dodatnie ID pozostaje obecne z name:null, jeśli nie zostało rozwiązane; istniejąca tekstowa etykieta źródła ma id:null. Nie jest wykonywane wyznaczanie miasta/jednostki nadrzędnej ani odwrotne geokodowanie. place to wskazany obiekt geograficzny, niekoniecznie miasto. Do wyświetlania odczytuj nazwy stąd; dodatkowe wyszukiwanie po stronie klienta nie jest potrzebne. Nazwy podlegają regułom lang i wartości zastępczych słownika. Wszystkie unikalne ID krajów/lokalizacji są zbierane z widocznych ogłoszeń w całej odpowiedzi przed zbiorczym wyszukiwaniem, w partiach po najwyżej 1000 dokumentów słownika. Puste zbiory ID nie wymagają wyszukiwania; nie ma żądań lokalizacji na pojedynczy samochód. Regionalne odwołania do samego siebie mogą dawać zduplikowane ID; usuwaj duplikaty etykiet po ID w obrębie przestrzeni nazw lokalizacji.

Atrybuty podrzędne: 4
countryobjectmoże być nullzawsze w odpowiedzi
Atrybuty podrzędne: 3
idintegermoże być nullzawsze w odpowiedzi

Wewnętrzne ID kraju, rozwiązywane przez /countries.

namestringmoże być nullzawsze w odpowiedzi

Lokalizowana nazwa kraju.

isostringmoże być nullzawsze w odpowiedzi

Kod ISO kraju wielkimi literami lub null, gdy niedostępny.

regionobjectmoże być nullzawsze w odpowiedzi
Atrybuty podrzędne: 2
idintegermoże być nullzawsze w odpowiedzi

Oryginalne ID lokalizacji lub null dla tekstowej etykiety pochodzącej ze źródła.

namestringmoże być nullzawsze w odpowiedzi

Lokalizowana nazwa lub null, gdy nierozwiązana.

districtobjectmoże być nullzawsze w odpowiedzi
Atrybuty podrzędne: 2
idintegermoże być nullzawsze w odpowiedzi

Oryginalne ID lokalizacji lub null dla tekstowej etykiety pochodzącej ze źródła.

namestringmoże być nullzawsze w odpowiedzi

Lokalizowana nazwa lub null, gdy nierozwiązana.

placeobjectmoże być nullzawsze w odpowiedzi
Atrybuty podrzędne: 2
idintegermoże być nullzawsze w odpowiedzi

Oryginalne ID lokalizacji lub null dla tekstowej etykiety pochodzącej ze źródła.

namestringmoże być nullzawsze w odpowiedzi

Lokalizowana nazwa lub null, gdy nierozwiązana.

imagesarray of objectzawsze w odpowiedzi

Dostępne URL-e jednego obrazu ogłoszenia. Każde pole jest opcjonalne i pomijane, gdy niedostępne. Wpisy bez żadnego URL są wykluczane; tablica images może być pusta. Nie są gwarantowane stałe wymiary ani dostępność wszystkich trzech wariantów.

Atrybuty podrzędne: 3
downloadedstring

URL kopii obrazu pobranej do naszego magazynu obrazów. Zwracany tylko wtedy, gdy dostępne są zarówno zapisana ścieżka pliku, jak i serwer obrazów; URL używa hosta obrazów skonfigurowanego dla domeny API.

previewstring

URL obrazu podglądu dostarczony przez źródło ogłoszenia. Przekazywany bez zmian; zwykle nadaje się na miniatury. Wymiary nie są gwarantowane.

originalstring

URL oryginalnego obrazu dostarczony przez źródło ogłoszenia. Przekazywany bez zmian; wskazuje obraz źródłowy, a nie naszą pobraną kopię.

videoarray of stringmoże być null

URL-e wideo. Zwraca tablicę (także []) lub null, gdy niedostępne; nigdy pojedynczy ciąg URL.

created_atstringmoże być null
last_seen_atstringmoże być null
updated_atstringmoże być null
auction_atstringmoże być null
priceobject
Atrybuty podrzędne: 4
pricenumbermoże być null
currencyobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
negotiablebooleanmoże być null
historyarray of objectmoże być null
Atrybuty podrzędne: 3
pricenumbermoże być null
currency_idintegermoże być null
created_atstringmoże być null
seller_typeobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
availabilityobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
conditionobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
damageobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
second_damageobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
airbag_stateobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
document_idobjectmoże być null
Atrybuty podrzędne: 2
idintegerzawsze w odpowiedzi
namestringmoże być nullzawsze w odpowiedzi
option_idsarray of integerzawsze w odpowiedzi
is_auctionbooleanmoże być null
current_bidnumbermoże być null
keys_availablebooleanmoże być null
is_manufacturer_certifiedbooleanmoże być null
has_history_reportsbooleanzawsze w odpowiedzi

Zawsze obecne, jako true lub false: czy to ogłoszenie ma co najmniej jeden publiczny raport historii pojazdu.

is_leasingboolean

Flaga leasingu ogłoszenia; pomijana, gdy źródło nie ma wartości logicznej. Filtr zapytania is_leasing=false obejmuje brakujące i null wartości źródła.

source_datamap | array of object

Niepusty obiekt lub tablica pochodzące ze źródła, przekazywane bez normalizacji. Pomijane, gdy niedostępne lub puste; zachowuj nieznane pola.

has_registrationboolean
descriptionstring
Ogłoszenie · wszystkie pola wypełnionePrzykład
{30 keys
"external": {3 keys
"id": "example-listing-1"
"domain": {2 keys
"id": 101
"name": "cars.example.com"
}
"url": "https://cars.example.com/listing/example-listing-1"
}
"archived": false
"title": {2 keys
"en": "Example SUV 2.0 Hybrid AWD Premium"
"pl": "Example SUV 2.0 Hybrid 4x4 Premium"
}
"odometer": 98700
"location": {6 keys
"iso": "PL"
"country": 177
"location_admin_1": 858787
"location_admin_2": 6695624
"location_id": 756135
"position": {2 keys
"lat": 52.22977
"lon": 21.01178
}
}
"location_details": {4 keys
"country": {3 keys
"id": 177
"name": "Poland"
"iso": "PL"
}
"region": {2 keys
"id": 858787
"name": "Masovian Voivodeship"
}
"district": {2 keys
"id": 6695624
"name": "Warszawa"
}
"place": {2 keys
"id": 756135
"name": "Warsaw"
}
}
"images": [2 items]
"video": [1 item
0: "https://cars.example.com/video/walkaround.mp4"
]
"created_at": "2026-08-01T09:00:00Z"
"last_seen_at": "2026-09-28T06:00:00Z"
"updated_at": "2026-09-20T12:00:00Z"
"auction_at": "2026-10-02T14:00:00Z"
"price": {4 keys
"price": 104900
"currency": {2 keys
"id": 119
"name": "pln"
}
"negotiable": true
"history": [3 items]
}
"seller_type": {2 keys
"id": 2
"name": "dealer"
}
"availability": {2 keys
"id": 1
"name": "in_stock"
}
"condition": {2 keys
"id": 1
"name": "used"
}
"damage": {2 keys
"id": 22
"name": "minor_dents_scratches"
}
"second_damage": {2 keys
"id": 18
"name": "rear"
}
"airbag_state": {2 keys
"id": 1
"name": "intact"
}
"document_id": {2 keys
"id": 1
"name": "certificate_of_title"
}
"option_ids": [5 items]
"is_auction": true
"current_bid": 91000
"keys_available": true
"is_manufacturer_certified": false
"has_history_reports": true
"is_leasing": false
"source_data": {2 keys}
"has_registration": true
"description": "Example description written by the seller. Shown as plain text."
}

Przykładowe wartości dobrane tak, aby pokazać każde pole. ID dla enumów, walut i lokalizacji są prawdziwe; nazwy, numery VIN i URL-e są zmyślone. Pole, którego nie widzisz w prawdziwej odpowiedzi, nie zostało dostarczone przez źródło.