CarStat.dev
Objekte

Objekti listing

Një shpallje në një faqe burimi. Çmimi, kilometrazhi, fotot, vendndodhja dhe të dhënat e shitësit ndodhen këtu. Çmimet janë në monedhën e vetë shpalljes dhe nuk konvertohen kurrë.

externalobjectgjithmonë në përgjigje
3 atribute bijë
idstringgjithmonë në përgjigje

ID e shpalljes në burim; e ndryshme nga ID-ja e brendshme e makinës.

domainobjectgjithmonë në përgjigje
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
urlstringgjithmonë në përgjigje
archivedbooleangjithmonë në përgjigje
titlemap | []

Hartë gjuhë-titull, e kthyer pa zgjedhur gjuhë sipas lang. Çelësat janë kode gjuhësh (për shembull en ose ko); përdorni një përkthim të disponueshëm si rezervë. Kthen null kur mungon, ose [] për një hartë PHP të ruajtur bosh.

odometernumbermund të jetë null
locationobject | []

Objekt i vjetër vendndodhjeje, ose [] kur nuk është i disponueshëm. Përdorni location_details për një format uniform ID/emër në të gjitha endpoint-et e automjeteve. /search dhe /listing zakonisht ekspozojnë ID-të e ruajtura; /cars, /cars/{car_id} dhe /cars/vin/{vin} përpiqen të zëvendësojnë country, location_admin_1, location_admin_2 dhe location_id me emra të lokalizuar, prandaj vlerat mund të jenë tekste ose ID të pazbërthyera. Zbërtheni country numerik përmes /countries/{id}; zbërtheni location_id, location_admin_1 dhe location_admin_2 numerikë përmes /locations/{id}, ose grupojini me ids[]. Mos dërgoni emra tashmë të lokalizuar si ID. Shihni endpoint-et e fjalorit të vendndodhjeve.

8 atribute bijë
isostringmund të jetë null
postal_codestringmund të jetë null
countryinteger | string
location_admin_1integer | string
location_admin_2integer | string
location_idinteger | string
location_admin_3integer | string

Vlerë administrative e burimit; jo ID e garantuar e fjalorit të vendndodhjeve.

positionobject
2 atribute bijë
latnumber
lonnumber
location_detailsobjectgjithmonë në përgjigje

Gjithmonë i pranishëm në çdo shpallje te /search, /cars, kërkimet sipas ID/VIN të makinës dhe te kërkimet e shpalljeve. E njëjta formë shtuese kudo; location i vjetër ruhet. country vjen nga country_id, region nga location_admin_1, district nga location_admin_2, place nga location_id. Çdo përbërës që mungon është null. Një ID pozitive e njohur mbetet e pranishme me name:null nëse nuk zbërthehet; një etiketë tekstuale ekzistuese e burimit ka id:null. Nuk bëhet asnjë nxjerrje qyteti/prindi ose gjeokodim i kundërt. place është hyrja gjeografike e referuar, jo domosdoshmërisht qytet. Lexoni emrat këtu për shfaqje; nuk nevojitet kërkim shtesë nga klienti. Emrat ndjekin lang dhe rregullat e rezervës së fjalorit. Të gjitha ID-të unike të shteteve/vendndodhjeve mblidhen nga shpalljet e dukshme në të gjithë përgjigjen përpara kërkimit në grup, në grupe me të shumtën 1000 dokumente fjalori. Grupet bosh të ID-ve nuk kërkojnë kërkim; nuk ka kërkesa vendndodhjeje për çdo makinë. Vetëreferencat rajonale mund të prodhojnë ID të dyfishta; hiqni etiketat e dyfishta sipas ID-së brenda hapësirës së emrave të vendndodhjeve.

4 atribute bijë
countryobjectmund të jetë nullgjithmonë në përgjigje
3 atribute bijë
idintegermund të jetë nullgjithmonë në përgjigje

ID e brendshme e shtetit, e zbërthyer përmes /countries.

namestringmund të jetë nullgjithmonë në përgjigje

Emri i lokalizuar i shtetit.

isostringmund të jetë nullgjithmonë në përgjigje

Kodi ISO i shtetit me shkronja të mëdha, ose null kur nuk është i disponueshëm.

regionobjectmund të jetë nullgjithmonë në përgjigje
2 atribute bijë
idintegermund të jetë nullgjithmonë në përgjigje

ID-ja origjinale e vendndodhjes, ose null për një etiketë tekstuale që i përket burimit.

namestringmund të jetë nullgjithmonë në përgjigje

Emri i lokalizuar, ose null kur nuk është zbërthyer.

districtobjectmund të jetë nullgjithmonë në përgjigje
2 atribute bijë
idintegermund të jetë nullgjithmonë në përgjigje

ID-ja origjinale e vendndodhjes, ose null për një etiketë tekstuale që i përket burimit.

namestringmund të jetë nullgjithmonë në përgjigje

Emri i lokalizuar, ose null kur nuk është zbërthyer.

placeobjectmund të jetë nullgjithmonë në përgjigje
2 atribute bijë
idintegermund të jetë nullgjithmonë në përgjigje

ID-ja origjinale e vendndodhjes, ose null për një etiketë tekstuale që i përket burimit.

namestringmund të jetë nullgjithmonë në përgjigje

Emri i lokalizuar, ose null kur nuk është zbërthyer.

imagesarray of objectgjithmonë në përgjigje

URL-të e disponueshme për një imazh të shpalljes. Çdo fushë është opsionale dhe mungon kur nuk është e disponueshme. Hyrjet pa asnjë URL përjashtohen; vargu images mund të jetë bosh. Nuk garantohen përmasa fikse ose disponueshmëria e të tri varianteve.

3 atribute bijë
downloadedstring

URL e kopjes së imazhit të shkarkuar në hapësirën tonë të ruajtjes së imazheve. Kthehet vetëm kur janë të disponueshëm si shtegu i skedarit të ruajtur, ashtu edhe serveri i imazheve; URL-ja përdor hostin e imazheve të konfiguruar për domenin e API-së.

previewstring

URL e imazhit paraprak e dhënë nga burimi i shpalljes. Kalohet pa ndryshime; zakonisht e përshtatshme për miniatura. Përmasat nuk garantohen.

originalstring

URL e imazhit origjinal e dhënë nga burimi i shpalljes. Kalohet pa ndryshime; tregon imazhin e burimit, jo kopjen tonë të shkarkuar.

videoarray of stringmund të jetë null

URL video. Kthen një varg (përfshirë []), ose null kur nuk është i disponueshëm; kurrë një tekst të vetëm URL.

created_atstringmund të jetë null
last_seen_atstringmund të jetë null
updated_atstringmund të jetë null
auction_atstringmund të jetë null
priceobject
4 atribute bijë
pricenumbermund të jetë null
currencyobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
negotiablebooleanmund të jetë null
historyarray of objectmund të jetë null
3 atribute bijë
pricenumbermund të jetë null
currency_idintegermund të jetë null
created_atstringmund të jetë null
seller_typeobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
availabilityobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
conditionobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
damageobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
second_damageobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
airbag_stateobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
document_idobjectmund të jetë null
2 atribute bijë
idintegergjithmonë në përgjigje
namestringmund të jetë nullgjithmonë në përgjigje
option_idsarray of integergjithmonë në përgjigje
is_auctionbooleanmund të jetë null
current_bidnumbermund të jetë null
keys_availablebooleanmund të jetë null
is_manufacturer_certifiedbooleanmund të jetë null
has_history_reportsbooleangjithmonë në përgjigje

Përfshihet gjithmonë, si true ose false: nëse kjo shpallje ka të paktën një raport publik historiku të automjetit.

is_leasingboolean

Flamuri i lizingut të shpalljes; mungon kur burimi nuk ka vlerë boolean. Filtri i query-t is_leasing=false përfshin vlerat e burimit që mungojnë dhe ato null.

source_datamap | array of object

Objekt ose varg jobosh që i përket burimit, i kaluar pa normalizim. Mungon kur nuk është i disponueshëm ose është bosh; ruani fushat e panjohura.

has_registrationboolean
descriptionstring
Listing · çdo fushë e plotësuarShembull
{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."
}

Vlera shembull të zgjedhura për të treguar çdo fushë. ID-të për enum-et, monedhën dhe vendndodhjet janë reale; emrat, VIN-et dhe URL-të janë të sajuara. Një fushë që nuk e shihni në një përgjigje reale nuk është dhënë nga burimi.