Об'єкт listing
Одне оголошення на одному сайті-джерелі. Тут містяться ціна, пробіг, фото, локація і дані продавця. Ціни вказано у власній валюті оголошення, і вони ніколи не конвертуються.
Дочірніх атрибутів: 3
ID оголошення джерела; відрізняється від внутрішнього ID автомобіля.
Дочірніх атрибутів: 2
Мапа «мова → заголовок», що повертається без вибору мови за lang. Ключі — коди локалей (наприклад, en або ko); як запасний варіант використовуйте наявний переклад. Повертає null, якщо відсутня, або [] для порожньої збереженої PHP-мапи.
Застарілий об'єкт 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
Адміністративне значення джерела; не гарантований ID довідника локацій.
Дочірніх атрибутів: 2
Завжди присутнє в кожному оголошенні в /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
Дочірніх атрибутів: 3
Внутрішній ID країни, розпізнається через /countries.
Локалізована назва країни.
Код ISO країни у верхньому регістрі або null, якщо недоступний.
Дочірніх атрибутів: 2
Початковий ID локації або null для текстової назви від джерела.
Локалізована назва або null, якщо не розпізнано.
Дочірніх атрибутів: 2
Початковий ID локації або null для текстової назви від джерела.
Локалізована назва або null, якщо не розпізнано.
Дочірніх атрибутів: 2
Початковий ID локації або null для текстової назви від джерела.
Локалізована назва або null, якщо не розпізнано.
Доступні URL для одного зображення оголошення. Кожне поле необов'язкове й пропускається, якщо недоступне. Записи без жодного URL виключаються; масив images може бути порожнім. Фіксовані розміри чи наявність усіх трьох варіантів не гарантуються.
Дочірніх атрибутів: 3
URL копії зображення, завантаженої в наше сховище зображень. Повертається лише тоді, коли доступні і шлях до збереженого файлу, і сервер зображень; URL використовує хост зображень, налаштований для домену API.
URL зображення для попереднього перегляду, наданий джерелом оголошення. Передається без змін; зазвичай підходить для мініатюр. Розміри не гарантуються.
URL оригінального зображення, наданий джерелом оголошення. Передається без змін; вказує на зображення джерела, а не на нашу завантажену копію.
URL відео. Повертає масив (зокрема []) або null, якщо недоступно; ніколи не окремий рядок URL.
Дочірніх атрибутів: 4
Дочірніх атрибутів: 2
Дочірніх атрибутів: 3
Дочірніх атрибутів: 2
Дочірніх атрибутів: 2
Дочірніх атрибутів: 2
Дочірніх атрибутів: 2
Дочірніх атрибутів: 2
Дочірніх атрибутів: 2
Дочірніх атрибутів: 2
Завжди присутнє як true або false: чи має це оголошення принаймні один публічний звіт про історію автомобіля.
Прапорець лізингу оголошення; пропускається, якщо джерело не має булевого значення. Фільтр запиту is_leasing=false включає відсутні та null значення джерела.
Непорожній об'єкт або масив, що належить джерелу, передається без нормалізації. Пропускається, якщо недоступний або порожній; зберігайте невідомі поля.
{30 keys
"external": {3 keys
"domain": {2 keys
"title": {2 keys
"location": {6 keys
"position": {2 keys
"location_details": {4 keys
"country": {3 keys
"region": {2 keys
"district": {2 keys
"place": {2 keys
"images": [2 items
]"video": [1 item
"price": {4 keys
"currency": {2 keys
"history": [3 items
]"seller_type": {2 keys
"availability": {2 keys
"condition": {2 keys
"damage": {2 keys
"second_damage": {2 keys
"airbag_state": {2 keys
"document_id": {2 keys
"option_ids": [5 items
]"source_data": {2 keys
}Приклади значень підібрано так, щоб показати всі поля. ID для enum, валюти та локацій справжні; назви, VIN та URL вигадані. Поле, якого немає в реальній відповіді, джерело не надало.
