CarStat.dev
Обекти

Обектът listing

Една обява в един сайт източник. Тук се намират цена, пробег, снимки, местоположение и данни за продавача. Цените са във валутата на самата обява и никога не се конвертират.

externalobjectвинаги в отговора
3 дъщерни атрибута
idstringвинаги в отговора

ID на обявата в източника; различно от вътрешното ID на автомобила.

domainobjectвинаги в отговора
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
urlstringвинаги в отговора
archivedbooleanвинаги в отговора
titlemap | []

Речник език–заглавие, връщан без избор на език според lang. Ключовете са кодове на локали (например en или ko); използвайте наличен превод като резервен вариант. Връща null, когато липсва, или [] за празен съхранен PHP речник.

odometernumberможе да е null
locationobject | []

Остарял обект location или [], когато не е наличен. Използвайте location_details за еднакъв формат ID/име във всички ендпойнти за автомобили. /search и /listing обикновено показват съхранените ID; /cars, /cars/{car_id} и /cars/vin/{vin} се опитват да заменят country, location_admin_1, location_admin_2 и location_id с локализирани имена, затова стойностите може да са низове или неразрешени ID. Разрешавайте числово country чрез /countries/{id}; разрешавайте числови location_id, location_admin_1 и location_admin_2 чрез /locations/{id} или ги групирайте с ids[]. Не изпращайте вече локализирани имена като ID. Вижте ендпойнтите на речника на местоположенията.

8 дъщерни атрибута
isostringможе да е null
postal_codestringможе да е null
countryinteger | string
location_admin_1integer | string
location_admin_2integer | string
location_idinteger | string
location_admin_3integer | string

Административна стойност от източника; не е гарантирано ID от речника на местоположенията.

positionobject
2 дъщерни атрибута
latnumber
lonnumber
location_detailsobjectвинаги в отговора

Винаги присъства във всяка обява в /search, /cars, търсенията по ID/VIN на автомобил и по обява. Навсякъде е със същата добавяща структура; остарялото location се запазва. country се взема от country_id, region от location_admin_1, district от location_admin_2, place от location_id. Всеки липсващ компонент е null. Известно положително ID остава с name:null, ако не е разрешено; съществуващ текстов етикет от източника има id:null. Не се извършва извеждане на град/родител или обратно геокодиране. place е посоченият географски запис, не непременно град. Четете имената оттук за показване; не е нужно допълнително търсене от клиента. Имената следват lang и правилата за резервни стойности на речника. Всички уникални ID на държави/местоположения се събират от видимите обяви в целия отговор преди груповото търсене, на партиди от най-много 1000 документа от речника. Празните набори от ID не изискват търсене; няма заявки за местоположение по автомобил. Регионалните самопрепратки може да доведат до дублирани ID; премахвайте дублираните етикети по ID в пространството от имена на местоположенията.

4 дъщерни атрибута
countryobjectможе да е nullвинаги в отговора
3 дъщерни атрибута
idintegerможе да е nullвинаги в отговора

Вътрешно ID на държава, разрешавано чрез /countries.

namestringможе да е nullвинаги в отговора

Локализирано име на държавата.

isostringможе да е nullвинаги в отговора

ISO код на държавата с главни букви или null, когато не е наличен.

regionobjectможе да е nullвинаги в отговора
2 дъщерни атрибута
idintegerможе да е nullвинаги в отговора

Оригинално ID на местоположението или null за текстов етикет, собственост на източника.

namestringможе да е nullвинаги в отговора

Локализирано име или null, когато не е разрешено.

districtobjectможе да е nullвинаги в отговора
2 дъщерни атрибута
idintegerможе да е nullвинаги в отговора

Оригинално ID на местоположението или null за текстов етикет, собственост на източника.

namestringможе да е nullвинаги в отговора

Локализирано име или null, когато не е разрешено.

placeobjectможе да е nullвинаги в отговора
2 дъщерни атрибута
idintegerможе да е nullвинаги в отговора

Оригинално ID на местоположението или null за текстов етикет, собственост на източника.

namestringможе да е nullвинаги в отговора

Локализирано име или null, когато не е разрешено.

imagesarray of objectвинаги в отговора

Налични URL адреси за едно изображение на обявата. Всяко поле е незадължително и се пропуска, когато не е налично. Записи без нито един URL се изключват; масивът images може да е празен. Не се гарантират фиксирани размери или наличие и на трите варианта.

3 дъщерни атрибута
downloadedstring

URL адрес на копието на изображението, изтеглено в нашето хранилище за изображения. Връща се само когато са налични и пътят до съхранения файл, и сървърът за изображения; URL адресът използва хоста за изображения, конфигуриран за домейна на API.

previewstring

URL адрес на изображение за преглед, предоставен от източника на обявата. Предава се без промяна; обикновено е подходящ за миниатюри. Размерите не са гарантирани.

originalstring

URL адрес на оригиналното изображение, предоставен от източника на обявата. Предава се без промяна; сочи към изображението в източника, а не към нашето изтеглено копие.

videoarray of stringможе да е null

URL адреси на видеоклипове. Връща масив (включително []) или null, когато не е наличен; никога единичен URL низ.

created_atstringможе да е null
last_seen_atstringможе да е null
updated_atstringможе да е null
auction_atstringможе да е null
priceobject
4 дъщерни атрибута
pricenumberможе да е null
currencyobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
negotiablebooleanможе да е null
historyarray of objectможе да е null
3 дъщерни атрибута
pricenumberможе да е null
currency_idintegerможе да е null
created_atstringможе да е null
seller_typeobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
availabilityobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
conditionobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
damageobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
second_damageobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
airbag_stateobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
document_idobjectможе да е null
2 дъщерни атрибута
idintegerвинаги в отговора
namestringможе да е nullвинаги в отговора
option_idsarray of integerвинаги в отговора
is_auctionbooleanможе да е null
current_bidnumberможе да е null
keys_availablebooleanможе да е null
is_manufacturer_certifiedbooleanможе да е null
has_history_reportsbooleanвинаги в отговора

Винаги присъства, като true или false: дали тази обява има поне един публичен доклад за историята на автомобила.

is_leasingboolean

Флаг за лизинг на обявата; пропуска се, когато източникът няма булева стойност. Филтърът на заявката is_leasing=false включва липсващи и null стойности от източника.

source_datamap | array of object

Непразен обект или масив, собственост на източника, предаден без нормализация. Пропуска се, когато не е наличен или е празен; запазвайте непознатите полета.

has_registrationboolean
descriptionstring
Listing · всички полета попълнениПример
{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."
}

Примерни стойности, подбрани така, че да покажат всички полета. ID за изброяванията, валутата и местоположенията са реални; имената, VIN номерата и URL адресите са измислени. Поле, което не виждате в реален отговор, не е предоставено от източника.