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
fuelpetrolBensiindieselDiiselhybridHübriidplugin_hybridPistikhübriidelectricElekterlpgGaas
bodyTypesedanSedaanwagonUniversaalhatchbackLuukpärasuvMaasturmpvMahtuniversaalcoupeKupeecabrioKabriolettpickupPikapvanKaubik
transmissionautomaticAutomaatmanualManuaal
drivefwdEsivedurwdTagaveduawdNelikvedu
conditionvery_goodVäga heagoodHeafairRahuldavneeds_repairVajab remonti
vatvat_includedsh käibemaks 24%margin_schemeKasutatud auto erikordnot_vat_registeredMüüja ei ole KM-kohustuslane
defects.categorybodyKeretyresRehvidinteriorSalongtechnicalTehnikaotherMuu
offerTypeused = 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→VANfuelBensiin→GASOLINEDiisel→DIESELHübriid→HYBRIDPistikhübriid→HYBRIDElekter→ELECTRICGaas→OTHERdriveEsivedu→FWDTagavedu→RWDNelikvedu→AWDconditionVäga hea→EXCELLENTHea→GOODRahuldav→FAIRVajab remonti→POORNä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