API декодування VIN

API декодування VIN: розшифруйте будь-який VIN у чистий JSON.

Надішліть 17-значний VIN і отримайте автомобіль таким, яким його зібрали: рік, марка, модель, комплектація, двигун, трансмісія, привід, тип кузова, завод і обладнання безпеки. Один запит, один ключ, структуровані поля, які можна зберігати й шукати.

Спробувати безкоштовно Довідник API

Безкоштовно для нового акаунта: 5 × Декодування VIN, 1 × Історія автомобіля і 1 × Наклейка Monroney. Картка не потрібна.

Python

import os, requests

res = requests.get(
    "https://api.autoparse.io/v1/vin/decode/2G1FK1EJ6A9133857",
    headers={"x-api-key": os.environ["AUTOPARSE_API_KEY"]},
    timeout=30,
)
res.raise_for_status()
print(res.json())

Огляд

Що таке API декодування VIN?

API декодування VIN від Autoparse є REST-ендпоінтом, який перетворює 17-значний ідентифікаційний номер транспортного засобу на структуровані дані про авто. Ви надсилаєте один GET-запит на /v1/vin/decode/{vin} із вашим API-ключем у заголовку x-api-key, а у відповідь отримуєте JSON з роком, маркою, моделлю та комплектацією, а також двигуном, трансмісією, приводом, типом кузова, заводом-виробником і обладнанням безпеки. Назви й типи полів однакові для всіх авто, тож перед збереженням чи пошуком не потрібно розбирати вільний текст. Успішне декодування коштує 1 кредит, а VIN без запису, помилка джерела чи тайм-аут ніколи не тарифікуються. Почати можна без картки, а потім перейти на щомісячну підписку або кредити за використанням, які не згорають. У довіднику API описано кожен параметр, поле відповіді та код помилки.

Що ви отримуєте

Структуровані дані, а не документи.

Основна ідентифікація

Рік, марка, модель і комплектація, а також виробник і тип транспортного засобу.

Силова установка

Модель двигуна, тип пального, кількість циліндрів, об’єм, тип трансмісії та ведучі колеса.

Кузов і зовнішній вигляд

Тип кузова, кількість дверей і повна дозволена маса.

Завод-виробник

Місто, регіон і країна заводу, де зібрано автомобіль.

Обладнання безпеки

Ремені безпеки, контроль тиску в шинах і подушки безпеки за рядами.

Нормалізований результат

Однакові назви й типи полів, тож вільний текст розбирати не потрібно.

Приклад відповіді

Що повертається.

Скорочена реальна відповідь для одного VIN. Масиви й вкладені об’єкти тут скорочено; у довіднику API показано кожне поле.

200 OK

{
  "vin": "2G1FK1EJ6A9133857",
  "body": "Coupe",
  "make": "Chevrolet",
  "trim": "2SS",
  "year": 2010,
  "model": "Camaro",
  "plant": "Oshawa, Ontario, Canada",
  "engine": {
    "fuel": "Gasoline",
    "model": "L99",
    "cylinders": 8,
    "injection": "Sequential Fuel Injection (SFI)",
    "other_info": "Alum",
    "manufacturer": "GM"
  }
}

Сценарії використання

Створено для реальної роботи.

Форми оголошень

Автоматично заповнюйте рік, марку, модель і комплектацію, щойно продавець вводить VIN, і зменшуйте кількість помилок ручного введення.

Склад і пошук

Нормалізуйте кожне авто під час завантаження, а потім фільтруйте за типом кузова, приводом чи пальним.

Страхування і кредитування

Переконайтеся, що авто в заявці відповідає VIN, перш ніж розраховувати чи схвалювати.

Автопарки та сервісні інструменти

Дізнавайтеся точний двигун і обладнання для підбору запчастин і графіків обслуговування.

Як це працює

Три кроки до першого запиту.

Створіть акаунт і згенеруйте API-ключ.
Викличте GET /v1/vin/decode/{vin}, передавши ключ у заголовку x-api-key.
Прочитайте JSON-відповідь. VIN без запису, помилка джерела чи тайм-аут ніколи не тарифікуються.

Перед запуском прочитайте, як автентифікуватися, як списуються кредити, які ліміти запитів і коди помилок.

Ціни

1кредит за успішний запит

Від приблизно $0.053 за запит на найбільших обсягах. Оформіть підписку з щомісячним лімітом або купіть пакети кредитів, які не згорають. Відсутні дані, помилки джерела та тайм-аути ніколи не тарифікуються.

Переглянути ціни

Запитання

API декодування VIN, відповіді.

Що повертає API декодування VIN?

Воно повертає характеристики, закодовані в 17-значному VIN: модельний рік, марку, модель, комплектацію, двигун, трансмісію, привід, тип кузова, завод-виробник і обладнання безпеки у вигляді структурованого JSON.

Як розшифрувати VIN за допомогою API?

Надішліть GET-запит на ендпоінт декодування, вказавши VIN у шляху, а API-ключ у заголовку x-api-key. У документації є готові приклади для curl, Node.js, Python і C#.

Чи стягується плата, якщо VIN не вдалося розшифрувати?

Ні. Якщо для VIN немає запису, постачальник даних дає збій або запит завершується тайм-аутом, плата не стягується. Кредити витрачаються лише тоді, коли ви отримали дані.

Який формат має коректний VIN?

VIN складається рівно з 17 символів: цифр і великих літер, і ніколи не містить літер I, O та Q. API перевіряє формат до будь-якого пошуку.

Більше від Autoparse