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
Оголошення · усі поля заповненоПриклад
{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 для enum, валюти та локацій справжні; назви, VIN та URL вигадані. Поле, якого немає в реальній відповіді, джерело не надало.