Autovaade
JSON · XML · v1

Фид склада (JSON и XML)

Автомобили автосалона, которые продаются на Autovaade, — для других систем: порталов, сайта автосалона, складской системы. Версия формата 1.

Адрес и обновление

GET https://autovaade.ee/feed/v1/<ключ>.jsonGET https://autovaade.ee/feed/v1/<ключ>.xml
  • Адрес фида создаёт владелец автосалона на странице Моё → Профиль компании → Импорт и экспорт. В адресе есть секретный ключ: кто знает адрес, может читать фид. При создании нового адреса старый перестаёт работать.
  • Одинаковое содержание в двух форматах: …/<ключ>.json и …/<ключ>.xml (UTF-8).
  • Фид обновляется в течение нескольких минут после изменения объявления. Читайте его не чаще раза в 15 минут; оптимально — раз в час.
  • У ответа есть ETag: передайте If-None-Match, и если склад не изменился, придёт 304 без содержимого.
  • В фиде только автомобили в продаже. Проданный или удалённый автомобиль исчезает из фида — удалите его и из своей системы.
  • Поле отсутствует, если значение неизвестно (в JSON нет значений null, в XML нет пустых элементов).

Поля

Фид

formatstring
Всегда "autovaade-inventory" (в XML — корневой элемент <inventory> с format="autovaade").
versioninteger
Версия формата: 1. Могут добавляться новые поля, существующие не меняются.
generatedAtdatetime
Когда фид был сформирован (UTC).
dealerobject
Данные автосалона (см. ниже).
countinteger
Количество автомобилей в фиде.
vehiclesarray
Автомобили в продаже, новые первыми.
equipmentCatalogobject
Названия кодов комплектации из фида: { код: { et, ru, en } }.

Автосалон (dealer)

namestring
Публичное название.
legalNamestring · может отсутствовать
Юридическое название.
regCodestring · может отсутствовать
Регистрационный код.
urlurl
Страница компании на Autovaade.
logoUrlurl · может отсутствовать
Логотип.
website, phone, emailstring · может отсутствовать
Контакты.
address, citystring · может отсутствовать
Адрес и город.
lat, lngnumber · может отсутствовать
Координаты.

Автомобиль: идентификатор и статус

idstring
Постоянный идентификатор объявления Autovaade (UUID). Используйте как ключ при импорте.
urlurl
Страница объявления на Autovaade.
statuscode
active — в продаже, reserved — забронирован (всё ещё в продаже).
reservedUntildatetime · может отсутствовать
Окончание брони.
stockNumberstring · может отсутствовать
Складской код продавца.
vinstring · может отсутствовать
VIN-код — только если продавец включил его в фид.
platestring · может отсутствовать
Номерной знак — только если продавец включил его в фид.
offerTypecode
used, new или demo.
publishedAtdatetime
Время публикации.
updatedAtdatetime
Когда видимое покупателю содержимое последний раз менялось (цена, данные, фото).

Автомобиль: данные

make, modelstring
Марка и модель.
variantstring · может отсутствовать
Версия (двигатель, комплектация).
bodyTypecode
Тип кузова (коды ниже).
fuelcode
Топливо.
transmissioncode
Коробка передач.
drivecode
Привод.
powerKwinteger
Мощность, кВт.
powerHpinteger
Мощность, л. с. (кВт × 1,36).
engineCcinteger · может отсутствовать
Объём двигателя, см³.
firstRegistrationdate
Первая регистрация.
mileageKminteger
Пробег, км.
colorstring · может отсутствовать
Цвет.
seatsinteger · может отсутствовать
Мест.
co2Wltpinteger · может отсутствовать
CO₂ (WLTP), г/км.
maxLadenMassinteger · может отсутствовать
Полная масса, кг.
batteryKwh, rangeKmnumber · может отсутствовать
Электромобили: ёмкость батареи (кВт·ч) и запас хода WLTP (км).
inspectionValidUntildate · может отсутствовать
Техосмотр действует до.

Цена и состояние

priceEurinteger
Цена в евро.
currency, priceAmountstring, integer · может отсутствовать
Валюта продавца и цена в ней, если это не евро (например, SEK); тогда priceEur пересчитан по курсу Европейского центрального банка.
vatcode · может отсутствовать
НДС (коды ниже).
exchangePossibleboolean
Возможен обмен.
conditioncode
Состояние.
serviceBookboolean · может отсутствовать
Есть сервисная книжка.
keysCountinteger · может отсутствовать
Ключей.
defectsarray
Недостатки, отмеченные продавцом: { category, text }.

Место, описание и комплектация

citystring
Город.
countystring · может отсутствовать
Уезд.
countrystring · может отсутствовать
Страна нахождения авто (ISO 3166-1, например FI), если не Эстония.
descriptionobject · может отсутствовать
Описание по языкам: { et, ru, en }.
descriptionSourcecode · может отсутствовать
Язык, на котором продавец написал описание.
machineTranslatedarray · может отсутствовать
Языки с машинным переводом.
equipmentarray
Коды комплектации; названия на трёх языках: equipmentCatalog. В XML: <item code="…">название на эстонском</item>.
equipmentExtraarray
Прочее оснащение (свободный текст продавца).

Фото и видео

photosarray
Адреса фото по порядку, первое — обложка (WebP, до 2048 px). Скачивайте фото, а не ссылайтесь на них напрямую.
videoFileobject · может отсутствовать
Видео, загруженное на Autovaade: { url, posterUrl, seconds }.
videoUrlurl · может отсутствовать
Ссылка на YouTube или Vimeo.

Отметки проверки (verification)

registryboolean
Технические данные взяты из регистра Транспортного департамента, а не введены продавцом.
registryFieldsarray
Поля, значения которых взяты из регистра.
hasVinboolean
У объявления есть VIN (даже если его нет в фиде).
mileageCheckcode
Пробег относительно последнего показания в регистре: ok, below (меньше, чем в регистре) или unknown.
registryOdometerKm, registryOdometerDateinteger, date · может отсутствовать
Последнее показание одометра в регистре и его дата.

Коды

fuel
  • petrolБензин
  • dieselДизель
  • hybridГибрид
  • plugin_hybridПодключаемый гибрид
  • electricЭлектро
  • lpgГаз
bodyType
  • sedanСедан
  • wagonУниверсал
  • hatchbackХэтчбек
  • suvВнедорожник
  • mpvМинивэн
  • coupeКупе
  • cabrioКабриолет
  • pickupПикап
  • vanФургон
transmission
  • automaticАвтомат
  • manualМеханика
drive
  • fwdПередний
  • rwdЗадний
  • awdПолный
condition
  • very_goodОчень хорошее
  • goodХорошее
  • fairУдовлетворительное
  • needs_repairТребует ремонта
vat
  • vat_includedвкл. НДС 24%
  • margin_schemeОсобый режим для б/у авто
  • not_vat_registeredПродавец не плательщик НДС
defects.category
  • bodyКузов
  • tyresШины
  • interiorСалон
  • technicalТехника
  • otherДругое
offerType

used — подержанный, new — новый, demo — демо-автомобиль

Meta (Facebook и Instagram)

Тот же склад в формате каталога автомобилей Meta (automotive inventory ads). Автосалон добавляет адрес в каталог автомобилей в Commerce Manager и запускает динамическую рекламу, которая ведёт покупателя на объявление на Autovaade.

  • Адрес: …/<ключ>.meta.xml — XML-формат Meta (<listings><listing>). В Commerce Manager — фид по расписанию, обновление ежедневно.
  • Фото в формате JPEG (Meta не принимает WebP), до 20 фото на автомобиль.
  • Забронированный автомобиль есть в каталоге, но availability = not_available: реклама его не показывает. Автомобиль без фото в фид не попадает.
  • Местоположение: адрес и координаты автосалона, если автомобиль в том же городе; иначе центр города автомобиля.
  • Описание на эстонском и без ссылок; если описания нет, формируется краткая сводка. Если цвет не указан, exterior_color = «Muu».
  • VIN и номерной знак (vehicle_registration_plate) есть в фиде, только если автосалон их включил.

Коды в Meta

bodyTypeСедан→SEDANУниверсал→WAGONХэтчбек→HATCHBACKВнедорожник→SUVМинивэн→MINIVANКупе→COUPEКабриолет→CONVERTIBLEПикап→PICKUPФургон→VAN
fuelБензин→GASOLINEДизель→DIESELГибрид→HYBRIDПодключаемый гибрид→HYBRIDЭлектро→ELECTRICГаз→OTHER
driveПередний→FWDЗадний→RWDПолный→AWD
conditionОчень хорошее→EXCELLENTХорошее→GOODУдовлетворительное→FAIRТребует ремонта→POOR

Пример

Один автомобиль, все поля (в том числе VIN и номер, если продавец их включил).

{
  "format": "autovaade-inventory",
  "version": 1,
  "generatedAt": "2026-10-03T09:00:00.000Z",
  "dealer": {
    "name": "Näidis Auto",
    "legalName": "Näidis Auto OÜ",
    "regCode": "12345678",
    "url": "https://autovaade.ee/ettevote/naidis-auto",
    "website": "https://naidisauto.ee",
    "phone": "+372 5555 0000",
    "email": "myyk@naidisauto.ee",
    "address": "Peterburi tee 1, Tallinn",
    "city": "Tallinn"
  },
  "count": 1,
  "vehicles": [
    {
      "id": "6d1f3c2e-8a41-4b7e-9c55-2f0a9e1b7d34",
      "url": "https://autovaade.ee/kuulutus/skoda-octavia-2019-6d1f3c2e",
      "status": "active",
      "stockNumber": "A-1001",
      "vin": "TMBJJ7NE4K0123456",
      "plate": "123ABC",
      "offerType": "used",
      "make": "Škoda",
      "model": "Octavia",
      "variant": "2.0 TDI Style",
      "bodyType": "wagon",
      "fuel": "diesel",
      "transmission": "automatic",
      "drive": "fwd",
      "powerKw": 110,
      "powerHp": 150,
      "engineCc": 1968,
      "firstRegistration": "2019-03-01",
      "mileageKm": 148500,
      "priceEur": 15900,
      "vat": "margin_scheme",
      "exchangePossible": true,
      "condition": "good",
      "color": "Hall",
      "seats": 5,
      "co2Wltp": 128,
      "maxLadenMass": 1950,
      "inspectionValidUntil": "2027-05-31",
      "serviceBook": true,
      "keysCount": 2,
      "city": "Tallinn",
      "county": "Harju maakond",
      "description": {
        "et": "Esimesest omanikust, hooldatud esinduses. Talverehvid valuveljedel kaasas.",
        "ru": "Первый владелец, обслуживался у дилера. Зимние шины на литых дисках в комплекте."
      },
      "descriptionSource": "et",
      "machineTranslated": [
        "ru"
      ],
      "equipment": [
        "climate_2zone",
        "seat_heating",
        "cruise_control",
        "parking_sensors",
        "apple_carplay",
        "led_lights",
        "towbar"
      ],
      "equipmentExtra": [
        "Talverehvid valuveljedel"
      ],
      "defects": [
        {
          "category": "body",
          "text": "Väike kriimustus tagastangel"
        }
      ],
      "photos": [
        "https://autovaade.ee/media/listing-photos/6d1f3c2e-8a41-4b7e-9c55-2f0a9e1b7d34/1.webp",
        "https://autovaade.ee/media/listing-photos/6d1f3c2e-8a41-4b7e-9c55-2f0a9e1b7d34/2.webp",
        "https://autovaade.ee/media/listing-photos/6d1f3c2e-8a41-4b7e-9c55-2f0a9e1b7d34/3.webp"
      ],
      "verification": {
        "registry": true,
        "registryFields": [
          "firstRegistration",
          "fuel",
          "make",
          "model",
          "powerKw"
        ],
        "hasVin": true,
        "mileageCheck": "ok",
        "registryOdometerKm": 141200,
        "registryOdometerDate": "2025-05-30"
      },
      "publishedAt": "2026-09-20T08:15:00.000Z",
      "updatedAt": "2026-10-01T10:05:00.000Z"
    }
  ],
  "equipmentCatalog": {
    "climate_2zone": {
      "et": "2-tsooniline kliima",
      "ru": "2-зонный климат-контроль",
      "en": "2-zone climate"
    },
    "seat_heating": {
      "et": "Istmesoojendus",
      "ru": "Подогрев сидений",
      "en": "Heated seats"
    },
    "cruise_control": {
      "et": "Püsikiirusehoidja",
      "ru": "Круиз-контроль",
      "en": "Cruise control"
    },
    "parking_sensors": {
      "et": "Parkimisandurid taga",
      "ru": "Парктроник сзади",
      "en": "Rear parking sensors"
    },
    "apple_carplay": {
      "et": "Apple CarPlay / Android Auto",
      "ru": "Apple CarPlay / Android Auto",
      "en": "Apple CarPlay / Android Auto"
    },
    "led_lights": {
      "et": "LED-esituled",
      "ru": "Светодиодные фары",
      "en": "LED headlights"
    },
    "towbar": {
      "et": "Haakekonks",
      "ru": "Фаркоп",
      "en": "Towbar"
    }
  }
}

Вопросы и предложения: tugi@autovaade.ee