Autovaade
JSON · XML · v1

Stock feed (JSON and XML)

A dealer's cars for sale on Autovaade, for other systems: portals, the dealer's own website, stock management. Format version 1.

Address and updates

GET https://autovaade.ee/feed/v1/<key>.jsonGET https://autovaade.ee/feed/v1/<key>.xml
  • The dealer's owner creates the feed address under Me → Business profile → Import & export. The address contains a secret key: anyone who has it can read the feed. Creating a new address stops the old one.
  • The same content in two formats: …/<key>.json and …/<key>.xml (UTF-8).
  • The feed updates within a few minutes of a listing change. Read it at most every 15 minutes; once an hour is fine.
  • Responses carry an ETag: send If-None-Match and you get a 304 with no body when the stock has not changed.
  • The feed only has cars that are for sale. A sold or removed car drops out of the feed — remove it from your system too.
  • A field is left out when the value is unknown (no null values in JSON, no empty elements in XML).

Fields

Feed

formatstring
Always "autovaade-inventory" (in XML: the root <inventory> element with format="autovaade").
versioninteger
Format version: 1. New fields may be added; existing ones do not change.
generatedAtdatetime
When the feed was generated (UTC).
dealerobject
The dealer (see below).
countinteger
Number of cars in the feed.
vehiclesarray
Cars for sale, newest first.
equipmentCatalogobject
Names of the equipment codes used in the feed: { code: { et, ru, en } }.

Dealer

namestring
Public name.
legalNamestring · may be missing
Legal name.
regCodestring · may be missing
Company registration code.
urlurl
The company page on Autovaade.
logoUrlurl · may be missing
Logo.
website, phone, emailstring · may be missing
Contacts.
address, citystring · may be missing
Address and city.
lat, lngnumber · may be missing
Map location.

Car: identity and status

idstring
Permanent Autovaade listing ID (UUID). Use it as the key when importing.
urlurl
The listing page on Autovaade.
statuscode
active = for sale, reserved = reserved (still for sale).
reservedUntildatetime · may be missing
Reservation end.
stockNumberstring · may be missing
The dealer's stock number.
vinstring · may be missing
VIN — only if the dealer chose to include it.
platestring · may be missing
Number plate — only if the dealer chose to include it.
offerTypecode
used, new or demo.
publishedAtdatetime
Published at.
updatedAtdatetime
When the content visible to buyers last changed (price, details, photos).

Car: details

make, modelstring
Make and model.
variantstring · may be missing
Version (engine, trim).
bodyTypecode
Body type (codes below).
fuelcode
Fuel.
transmissioncode
Transmission.
drivecode
Drive.
powerKwinteger
Power, kW.
powerHpinteger
Power, hp (kW × 1.36).
engineCcinteger · may be missing
Engine displacement, cm³.
firstRegistrationdate
First registration.
mileageKminteger
Mileage, km.
colorstring · may be missing
Colour.
seatsinteger · may be missing
Seats.
co2Wltpinteger · may be missing
CO₂ (WLTP), g/km.
maxLadenMassinteger · may be missing
Gross weight, kg.
batteryKwh, rangeKmnumber · may be missing
Electric cars: battery capacity (kWh) and WLTP range (km).
inspectionValidUntildate · may be missing
Roadworthiness test valid until.

Price and condition

priceEurinteger
Price in euros.
currency, priceAmountstring, integer · may be missing
Seller currency and the price in it, if not euro (e.g. SEK); priceEur is then converted at the European Central Bank rate.
vatcode · may be missing
VAT (codes below).
exchangePossibleboolean
Trade-in possible.
conditioncode
Condition.
serviceBookboolean · may be missing
Service book available.
keysCountinteger · may be missing
Keys.
defectsarray
Defects noted by the seller: { category, text }.

Location, description and equipment

citystring
City.
countystring · may be missing
County.
countrystring · may be missing
Country where the car is located (ISO 3166-1, e.g. FI), if not Estonia.
descriptionobject · may be missing
Description by language: { et, ru, en }.
descriptionSourcecode · may be missing
The language the seller wrote the description in.
machineTranslatedarray · may be missing
Machine-translated languages.
equipmentarray
Equipment codes; names in three languages: equipmentCatalog. In XML: <item code="…">Estonian name</item>.
equipmentExtraarray
Other extras (seller's free text).

Photos and video

photosarray
Photo URLs in order, the first is the cover (WebP, up to 2048 px). Download the images instead of hotlinking them.
videoFileobject · may be missing
Video uploaded to Autovaade: { url, posterUrl, seconds }.
videoUrlurl · may be missing
YouTube or Vimeo link.

Verification marks

registryboolean
Technical details come from the Estonian Transport Administration register, not typed by the seller.
registryFieldsarray
Fields whose value came from the register.
hasVinboolean
The listing has a VIN (even if it is not included in the feed).
mileageCheckcode
Mileage against the last register reading: ok, below (lower than registered) or unknown.
registryOdometerKm, registryOdometerDateinteger, date · may be missing
The last odometer reading in the register and its date.

Codes

fuel
  • petrolPetrol
  • dieselDiesel
  • hybridHybrid
  • plugin_hybridPlug-in hybrid
  • electricElectric
  • lpgLPG
bodyType
  • sedanSedan
  • wagonEstate
  • hatchbackHatchback
  • suvSUV
  • mpvMPV
  • coupeCoupé
  • cabrioConvertible
  • pickupPickup
  • vanVan
transmission
  • automaticAutomatic
  • manualManual
drive
  • fwdFront-wheel
  • rwdRear-wheel
  • awdAll-wheel
condition
  • very_goodVery good
  • goodGood
  • fairFair
  • needs_repairNeeds repair
vat
  • vat_includedincl. 24% VAT
  • margin_schemeSecond-hand margin scheme
  • not_vat_registeredSeller not VAT registered
defects.category
  • bodyBody
  • tyresTyres
  • interiorInterior
  • technicalTechnical
  • otherOther
offerType

used, new, demo = demonstrator

Meta (Facebook and Instagram)

The same stock in Meta’s vehicle catalog format (automotive inventory ads). The dealer adds the address to a Vehicles catalog in Commerce Manager and runs dynamic car ads that take buyers to the listing on Autovaade.

  • Address: …/<key>.meta.xml — Meta XML format (<listings><listing>). In Commerce Manager: a scheduled feed, updated daily.
  • Photos are JPEG (Meta does not accept WebP), up to 20 per car.
  • A reserved car stays in the catalog with availability = not_available, so ads don’t show it. Cars without photos are left out.
  • Location: the dealer’s address and coordinates when the car is in the same city; otherwise the centre of the car’s city.
  • Description in Estonian without links; if there is none, a short summary is generated. Missing colour: exterior_color = “Muu”.
  • VIN and number plate (vehicle_registration_plate) are only included if the dealer chose to.

Codes in Meta

bodyTypeSedan→SEDANEstate→WAGONHatchback→HATCHBACKSUV→SUVMPV→MINIVANCoupé→COUPEConvertible→CONVERTIBLEPickup→PICKUPVan→VAN
fuelPetrol→GASOLINEDiesel→DIESELHybrid→HYBRIDPlug-in hybrid→HYBRIDElectric→ELECTRICLPG→OTHER
driveFront-wheel→FWDRear-wheel→RWDAll-wheel→AWD
conditionVery good→EXCELLENTGood→GOODFair→FAIRNeeds repair→POOR

Example

One car with all fields (including VIN and number plate if the dealer included them).

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

Questions and suggestions: tugi@autovaade.ee