JSON · XML · v1

Laoseisu feed (JSON ja XML)

Automüüja müügis olevad autod Autovaatest teistesse süsteemidesse: portaalid, automüüja koduleht, laosüsteem. Vormingu versioon 1.

Aadress ja uuendamine

GET https://autovaade.ee/feed/v1/<võti>.jsonGET https://autovaade.ee/feed/v1/<võti>.xml
  • Feedi aadressi loob automüüja omanik lehel Minu → Ettevõtte profiil → Import ja eksport. Aadressis on salajane võti: kes aadressi teab, saab feedi lugeda. Uue aadressi loomisel vana lakkab töötamast.
  • Sama sisu kahes vormingus: …/<võti>.json ja …/<võti>.xml (UTF-8).
  • Feed uueneb mõne minuti jooksul pärast kuulutuse muutmist. Loe seda kuni kord 15 minuti jooksul; sobiv on kord tunnis.
  • Vastusel on ETag: saada päringus If-None-Match ja muutmata laoseisu korral tuleb 304 ilma sisuta.
  • Feedis on ainult müügis olevad autod. Müüdud või eemaldatud auto kaob feedist — eemalda see ka enda süsteemist.
  • Väli puudub, kui väärtus pole teada (JSON-is null-väärtusi pole, XML-is tühje elemente pole).

Väljad

Feed

formatstring
Alati "autovaade-inventory" (XML-is juurelemendi <inventory> atribuut format="autovaade").
versioninteger
Vormingu versioon: 1. Uued väljad võivad lisanduda, olemasolevad ei muutu.
generatedAtdatetime
Millal feed koostati (UTC).
dealerobject
Automüüja andmed (vt allpool).
countinteger
Autode arv feedis.
vehiclesarray
Müügis olevad autod, uuemad ees.
equipmentCatalogobject
Feedis olevate varustuse koodide nimed: { kood: { et, ru, en } }.

Automüüja (dealer)

namestring
Avalik nimi.
legalNamestring · võib puududa
Juriidiline nimi.
regCodestring · võib puududa
Registrikood.
urlurl
Ettevõtte leht Autovaates.
logoUrlurl · võib puududa
Logo.
website, phone, emailstring · võib puududa
Kontaktid.
address, citystring · võib puududa
Aadress ja linn.
lat, lngnumber · võib puududa
Asukoht kaardil.

Auto: tunnus ja olek

idstring
Autovaate kuulutuse püsiv tunnus (UUID). Kasuta seda impordis võtmena.
urlurl
Kuulutuse leht Autovaates.
statuscode
active = müügis, reserved = broneeritud (endiselt müügis).
reservedUntildatetime · võib puududa
Broneeringu lõpp.
stockNumberstring · võib puududa
Müüja laokood.
vinstring · võib puududa
VIN-kood — ainult siis, kui müüja selle feedi lisas.
platestring · võib puududa
Numbrimärk — ainult siis, kui müüja selle feedi lisas.
offerTypecode
used, new või demo.
publishedAtdatetime
Avaldamise aeg.
updatedAtdatetime
Millal ostjale nähtav sisu viimati muutus (hind, andmed, pildid).

Auto: andmed

make, modelstring
Mark ja mudel.
variantstring · võib puududa
Versioon (mootor, varustustase).
bodyTypecode
Keretüüp (koodid allpool).
fuelcode
Kütus.
transmissioncode
Käigukast.
drivecode
Vedu.
powerKwinteger
Võimsus, kW.
powerHpinteger
Võimsus, hj (kW × 1,36).
engineCcinteger · võib puududa
Mootori töömaht, cm³.
firstRegistrationdate
Esmane registreerimine.
mileageKminteger
Läbisõit, km.
colorstring · võib puududa
Värv.
seatsinteger · võib puududa
Istekohti.
co2Wltpinteger · võib puududa
CO₂ (WLTP), g/km.
maxLadenMassinteger · võib puududa
Täismass, kg.
batteryKwh, rangeKmnumber · võib puududa
Elektriautol aku mahutavus (kWh) ja sõiduulatus WLTP (km).
inspectionValidUntildate · võib puududa
Tehnoülevaatus kehtib kuni.

Hind ja seisukord

priceEurinteger
Hind eurodes.
currency, priceAmountstring, integer · võib puududa
Müüja valuuta ja hind selles, kui see pole euro (nt SEK); priceEur on siis Euroopa Keskpanga kursiga ümber arvestatud.
vatcode · võib puududa
Käibemaks (koodid allpool).
exchangePossibleboolean
Vahetus võimalik.
conditioncode
Seisukord.
serviceBookboolean · võib puududa
Hooldusraamat olemas.
keysCountinteger · võib puududa
Võtmeid.
defectsarray
Müüja märgitud puudused: { category, text }.

Asukoht, kirjeldus ja varustus

citystring
Linn.
countystring · võib puududa
Maakond.
countrystring · võib puududa
Auto asukoha riik (ISO 3166-1, nt FI), kui see pole Eesti.
descriptionobject · võib puududa
Kirjeldus keelte kaupa: { et, ru, en }.
descriptionSourcecode · võib puududa
Keel, milles müüja kirjelduse kirjutas.
machineTranslatedarray · võib puududa
Masintõlkega keeled.
equipmentarray
Varustuse koodid; nimed kolmes keeles: equipmentCatalog. XML-is <item code="…">eestikeelne nimi</item>.
equipmentExtraarray
Muud lisad (müüja vabatekst).

Pildid ja video

photosarray
Piltide aadressid järjekorras, esimene on kaanepilt (WebP, kuni 2048 px). Laadi pildid alla, ära viita neile otse.
videoFileobject · võib puududa
Autovaatesse laaditud video: { url, posterUrl, seconds }.
videoUrlurl · võib puududa
YouTube'i või Vimeo link.

Kontrollimärgid (verification)

registryboolean
Tehnilised andmed on Transpordiameti registrist, mitte müüja sisestatud.
registryFieldsarray
Väljad, mille väärtus tuli registrist.
hasVinboolean
Kuulutusel on VIN-kood (ka siis, kui seda feedis pole).
mileageCheckcode
Läbisõit registri viimase näidu suhtes: ok, below (väiksem kui registris) või unknown.
registryOdometerKm, registryOdometerDateinteger, date · võib puududa
Registri viimane läbisõidu näit ja selle kuupäev.

Koodid

fuel
  • petrolBensiin
  • dieselDiisel
  • hybridHübriid
  • plugin_hybridPistikhübriid
  • electricElekter
  • lpgGaas
bodyType
  • sedanSedaan
  • wagonUniversaal
  • hatchbackLuukpära
  • suvMaastur
  • mpvMahtuniversaal
  • coupeKupee
  • cabrioKabriolett
  • pickupPikap
  • vanKaubik
transmission
  • automaticAutomaat
  • manualManuaal
drive
  • fwdEsivedu
  • rwdTagavedu
  • awdNelikvedu
condition
  • very_goodVäga hea
  • goodHea
  • fairRahuldav
  • needs_repairVajab remonti
vat
  • vat_includedsh käibemaks 24%
  • margin_schemeKasutatud auto erikord
  • not_vat_registeredMüüja ei ole KM-kohustuslane
defects.category
  • bodyKere
  • tyresRehvid
  • interiorSalong
  • technicalTehnika
  • otherMuu
offerType

used = kasutatud, new = uus, demo = demoauto

Meta (Facebook ja Instagram)

Sama laoseis Meta sõidukikataloogi vormingus (automotive inventory ads). Automüüja lisab aadressi Commerce Manageris sõidukite kataloogi ja teeb dünaamilised autokuulutused, mis viivad ostja kuulutusele Autovaates.

  • Aadress: …/<võti>.meta.xml — Meta XML-vorming (<listings><listing>). Commerce Manageris ajastatud feed, uuendus iga päev.
  • Pildid on JPEG-vormingus (Meta ei võta WebP-d), kuni 20 pilti auto kohta.
  • Broneeritud auto on kataloogis, aga availability = not_available: reklaam seda ei näita. Pildita auto feedi ei lähe.
  • Asukoht: automüüja aadress ja koordinaadid, kui auto on samas linnas; muidu auto linna keskpunkt.
  • Kirjeldus eesti keeles ja ilma linkideta; kui kirjeldust pole, tehakse lühikokkuvõte. Värvi puudumisel exterior_color = „Muu“.
  • VIN ja numbrimärk (vehicle_registration_plate) on feedis ainult siis, kui automüüja need lisas.

Koodid Metas

bodyTypeSedaan→SEDANUniversaal→WAGONLuukpära→HATCHBACKMaastur→SUVMahtuniversaal→MINIVANKupee→COUPEKabriolett→CONVERTIBLEPikap→PICKUPKaubik→VAN
fuelBensiin→GASOLINEDiisel→DIESELHübriid→HYBRIDPistikhübriid→HYBRIDElekter→ELECTRICGaas→OTHER
driveEsivedu→FWDTagavedu→RWDNelikvedu→AWD
conditionVäga hea→EXCELLENTHea→GOODRahuldav→FAIRVajab remonti→POOR

Näide

Üks auto, kõik väljad (sh VIN ja numbrimärk, kui müüja need lisas).

{
  "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"
    }
  }
}

Küsimused ja ettepanekud: tugi@autovaade.ee