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

Fusha shtesë të njoftimeve

Lidhni një çelës për të parë fushat e domeneve të lejuara.

custom_fieldsmap

Vlerat e publikuara dhe të indeksuara të këtij njoftimi dhe lidhjeve të tij aktive me domenet. GET /listing-fields jep çelësat, llojet dhe kufizimet e lejuara. Ruani zeron, false dhe vargjet homogjene. Vlerat që mungojnë nuk përfshihen. Të dhënat e paindeksuara mbeten në source_data; pa plotësim të historisë.

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 origjinal i burimit; mungon kur është i padisponueshëm ose bosh. Fushat e regjistruara pa indeksim, llojet dhe rrugët e ruajtjes përshkruhen nga GET /listing-fields i autentikuar; null i shprehur pastron vlerën e ruajtur me lloj të përcaktuar. Ruani fushat e panjohura. Vlerësimet historike krahasuese nuk zëvendësojnë çmimet e listimit; mos supozoni monedhën e tyre.

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.

Merrni qasje në API

Lidhni çelësin për të ekzekutuar çdo kërkesë nga këto faqe me të dhënat tuaja. Ende pa çelës? Na kërkoni një çelës demo: i njëjti JSON si në planet me pagesë.

Kam një çelës