Перейти до вмісту
API наклейки Monroney

API наклейки Monroney: оригінальна наклейка у вигляді даних.

Отримайте наклейку Monroney, з якою авто вийшло із заводу: базова MSRP, плата за доставку, кожна заводська опція та пакет із ціною, стандартне обладнання та витрата пального за EPA. Покажіть, скільки авто насправді коштувало новим.

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

Python
import os, requests

res = requests.get(
    "https://api.autoparse.io/v1/window-sticker/WDDUG8GBXJA338350",
    headers={"x-api-key": os.environ["AUTOPARSE_API_KEY"]},
    timeout=30,
)
res.raise_for_status()
print(res.json())
Огляд

Що таке API наклейки Monroney?

API наклейки Monroney від Autoparse повертає оригінальну наклейку Monroney для автомобіля у форматі JSON. Ви надсилаєте один GET-запит на /v1/window-sticker/{vin} зі своїм API-ключем, а у відповідь отримуєте базову MSRP, плату за доставку, кожну заводську опцію та пакет із ціною, стандартне обладнання за категоріями, витрату пального за EPA та умови гарантії. Наклейка Monroney є цінником, який новий автомобіль має при виході із заводу, тож дані фіксують, як авто було зібрано і скільки воно коштувало новим. Використовуйте їх, щоб показувати оригінальне обладнання в оголошеннях, коригувати оцінку з урахуванням встановлених опцій або перевіряти, чи комплектація відповідає опису. Кожен успішний запит коштує фіксовану кількість кредитів, зазначену на сторінці цін, а VIN без наклейки, помилка джерела чи тайм-аут ніколи не тарифікуються. У довіднику API описано кожне поле.

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

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

Ціни

Базова MSRP, плата за доставку, загальна вартість опцій і підсумкова MSRP.

Пакети й опції

Заводські пакети та окремі опції, кожна з кодом, назвою та ціною.

Стандартне обладнання

Усе, що входить без доплати, за категоріями.

Характеристики

Кількість місць, бак, споряджена маса, колісна база та розмір шин.

Витрата пального

Витрата EPA в місті, на трасі та змішана в MPG, а також оцінка річних витрат на пальне.

Гарантія

Умови базової гарантії, гарантії на силову установку та допомоги на дорозі.

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

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

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

200 OK
{
  "vin": "WDDUG8GBXJA338350",
  "options": {
    "packages": [
      {},
      {}
    ],
    "individual": [
      {},
      {}
    ]
  },
  "pricing": {
    "currency": "USD",
    "base_msrp": 102900,
    "total_msrp": 123880,
    "currency_sign": "$",
    "options_total": 19985,
    "destination_charge": 995
  },
  "vehicle": {
    "make": "Mercedes-Benz",
    "trim": "S560 4MATIC",
    "year": 2018,
    "doors": 4,
    "model": "S-Class",
    "engine": "4.0L V8"
  },
  "sections": [
    {
      "items": [],
      "title": "Engine"
    },
    {
      "items": [],
      "title": "Transmission"
    }
  ],
  "warranty": {
    "basic": "48 month/50,000 miles",
    "roadside": "48 month/50,000 miles",
    "powertrain": "48 month/50,000 miles"
  },
  "fuel_economy": {
    "is_mpge": false,
    "city_mpg": 17,
    "highway_mpg": 27,
    "combined_mpg": 21,
    "co2_emissions": null,
    "kwh_per_100mi": null
  },
  "identity_strip": [
    {
      "label": "Body Type",
      "value": "Sedan"
    },
    {
      "label": "Engine",
      "value": "4.0L V8"
    }
  ]
}
Сценарії використання

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

Сторінки авто

Показуйте оригінальну MSRP та встановлені опції поруч із запитуваною ціною.

Оцінка вартості

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

Перевірка оголошень

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

Інструменти для покупців

Дайте покупцям змогу порівняти, чим було оснащено два схожі авто.

Як це працює

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

  1. Створіть акаунт і згенеруйте API-ключ.
  2. Викличте GET /v1/window-sticker/{vin}, передавши ключ у заголовку x-api-key.
  3. Прочитайте JSON або скористайтеся документом, який повертає ендпоінт, залежно від інтеграції, яку ви будуєте.

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

Ціни
20кредитів за успішний запит

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

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

Запитання

API наклейки Monroney, відповіді.

Що таке віконна наклейка?

Це наклейка Monroney, що кріпиться на нове авто. У ній вказано базову ціну, плату за доставку, встановлені на заводі опції та пакети з цінами, стандартне обладнання та витрату пального за EPA.

Що повертає API наклейки Monroney?

Оригінальну наклейку для VIN у вигляді структурованих даних: ціни, опції та пакети, стандартне обладнання за категоріями, характеристики, витрату пального за EPA та умови гарантії.

Чи можна отримати наклейку для будь-якого VIN?

Покриття залежить від виробника та модельного року. Якщо для VIN наклейки немає, плата не стягується.

Скільки коштує API наклейки Monroney?

Кожен успішний запит коштує фіксовану кількість кредитів, вказану на сторінці цін. Невдалі запити ніколи не тарифікуються.