Hooga

For dealers and their IT partners

Stock feed

Publish your cars for sale as one XML or JSON file at an https address. Hooga reads it every hour and keeps your listings in line with it. Listing and importing are both free.

How it works

  1. 01

    Publish the file

    Your stock system writes every car that is for sale into one file, XML or JSON, at an https address.

  2. 02

    Add its address

    The owner of the dealer profile adds the address on the "Stock import" tab. We read the file at once and show what we found in it: the cars and the remarks. Nothing is published yet.

  3. 03

    Start importing

    From then on we read the file every hour: new cars appear, changed ones are updated, cars that left the file are taken down.

Already sending your stock to another portal?

Send that file, or its address, to [email protected]. If it carries what a car listing needs, we add its format and you change nothing on your side.

Shape of the file

One entry per car. Field names and values are the same in both formats, and we tell the formats apart ourselves. The file is UTF-8.

  • JSON: an object with the list "cars" (a bare list of cars is read too). {"cars": [{ ... }, { ... }]}
  • XML: the root element "cars" with one "car" element per car. <cars><car> ... </car></cars>

In XML the headline and the description are repeated once per language with the attribute lang, the equipment is a list of "item" elements and the photos a list of "photo" elements. The example below shows all of it.

Fields of one car

The required fields are exactly what the "sell a car" form asks for before a car can be published. A car without one of them is skipped and named in the log; the rest of the file is imported.

Field Required What goes in it
external_id yes Your own number for the car, up to 191 characters. It must stay the same for as long as the car is in the file: that is how we recognise it.
status no live (the default), paused or sold. See the rules below.
make yes The make as our list writes it: "Volkswagen", "Škoda", "Mercedes-Benz". "VW", "Skoda" and "Mercedes" are understood. A car of a make we do not list is skipped: write to us and we add the make.
model yes The model: "Golf". When our list has it we write it our way, otherwise it is kept as you typed it.
variant no Engine and trim as you would say them: "1.5 TSI Style". Up to 80 characters.
year yes Year of first registration.
month no Month of first registration, 1 to 12. Instead of year and month you may send first_registration, for example "2019-03".
mileage_km yes Odometer reading in kilometres.
price yes The price a buyer pays, in whole euros.
vat_deductible no true when the price includes VAT and the buyer gets an invoice with VAT. false when left out.
fuel yes One of the values below.
gearbox yes manual or automatic.
drive no front, rear or awd.
body no One of the values below.
power_kw no Engine power in kilowatts. A value in horsepower ("150 hp") is converted.
engine_cc no Engine size in cubic centimetres. "1.5" is read as litres.
color no One of the values below. A longer colour name ("Tumehall metallik") is matched to the nearest one.
doors no 2 to 6.
seats no 1 to 9.
owners no How many owners the car has had.
condition no One of the values below.
service_history no One of the values below.
inspection_until no The month the roadworthiness inspection is valid until: "2027-03".
imported_from no Two-letter code of the country the car was brought from. Leave it out for a car first sold in Estonia.
vin no The 17 characters of the VIN. Stored with the listing, never shown publicly.
plate no The number plate. Stored with the listing, never shown publicly.
equipment no A list of the values below. What is not on the list belongs in the description.
county no One of the 15 counties as written below. "Harjumaa" is understood.
city yes The town or municipality where the car can be seen, in Estonian: "Tallinn".
headline yes One line per language (et, ru, en), up to 80 characters.
description yes The text per language (et, ru, en), up to 3 000 characters. HTML is turned into plain text. At least one language needs both a headline and a description.
photos yes https addresses of the photos in the order they are shown; the first one is the cover. At least one, at most 50.
video_url no A YouTube link.
agent_email no The sign-in e-mail of the person in your sales team who sells this car: the listing carries their name and their inbox gets the messages. Left out, or an e-mail that is not in your team: the owner of the dealer profile.
updated_at no When you last changed the car. Optional and not used: we compare the content itself.

Allowed values

Send the values exactly as written here.

status
live paused sold
fuel
petrol diesel hybrid plugin_hybrid electric gas
gearbox
manual automatic
drive
front rear awd
body
hatchback sedan estate suv coupe convertible minivan pickup van
color
white black grey silver blue red green brown beige yellow orange other
condition
excellent good fair needs_work
service_history
full_dealer full_independent partial none
equipment
led_headlights adaptive_cruise cruise_control heated_seats heated_steering_wheel carplay navigation parking_sensors parking_camera tow_bar sunroof leather keyless digital_cockpit climate_control parking_heater winter_tyres roof_rails
imported_from
DE SE FI LV LT PL NL BE FR IT ES AT CH DK NO GB US JP KR
county
Harju maakond Hiiu maakond Ida-Viru maakond Jõgeva maakond Järva maakond Lääne maakond Lääne-Viru maakond Põlva maakond Pärnu maakond Rapla maakond Saare maakond Tartu maakond Valga maakond Viljandi maakond Võru maakond

We also read the usual other ways of writing them: capital letters, the Estonian, Russian and English words ("Automaat", "diisel", "универсал"), numbers with spaces or units ("84 200 km", "110 kW"). An optional value we cannot read is left out and noted in the log. Only a required field can make us skip a car.

Rules and limits

  • The file is read once an hour. A read that fails changes nothing; we then wait longer before the next try (1 h, 3 h, 12 h, 24 h), and after 3 failures in a row the owner of the profile gets one e-mail.
  • Nothing is published before the owner of the dealer profile has seen the preview and pressed "Start importing".
  • Cars are matched by external_id. A car whose entry did not change is not touched. Cars you added by hand on the site have no external_id, and the import never touches them.
  • A car that is missing from 2 successful reads in a row is taken off the site. When the file lists it again, it comes back on the same page.
  • A new price goes into the price history of the car, the same way as a price you change by hand.
  • status "paused" keeps the car in your account and off the site, "sold" marks it sold. A change of status in the file is followed once: what you then change by hand on the site stays until the file says something new.
  • Photos: up to 50 per car, https only, JPEG, PNG or WebP, up to 25 MB each. We download each photo once and keep our own copy without location and camera data. A photo that fails is tried again at the next read, and a car goes public once at least one photo has arrived.
  • The file: up to 20 MB and 5 000 cars, answered within 20 seconds at a public https address, at most 3 redirects. There is no sign-in: to keep the address private, put a long random part in it.
  • A dealer can have up to 5 files. A file can also be uploaded once by hand: that imports its cars and never takes any down.
  • Nothing in the file is checked against any outside source and nothing is added to it: the page of a car says what you sent.

Faster than once an hour

A system that knows when a car changes can send that one car at once through the listing API: the same fields, one car per request. Access is switched on per dealer on request.

Listing API

A complete example

Three cars: the first with every field, the last with only the required ones. Both files hold the same cars.

hooga-feed-example.xml Download
<?xml version="1.0" encoding="UTF-8"?>
<cars>
  <car>
    <external_id>A-1041</external_id>
    <status>live</status>
    <make>Volkswagen</make>
    <model>Golf</model>
    <variant>1.5 TSI Style</variant>
    <year>2019</year>
    <month>3</month>
    <mileage_km>84200</mileage_km>
    <price>16900</price>
    <vat_deductible>true</vat_deductible>
    <fuel>petrol</fuel>
    <gearbox>automatic</gearbox>
    <drive>front</drive>
    <body>hatchback</body>
    <power_kw>110</power_kw>
    <engine_cc>1498</engine_cc>
    <color>grey</color>
    <doors>5</doors>
    <seats>5</seats>
    <owners>1</owners>
    <condition>good</condition>
    <service_history>full_dealer</service_history>
    <inspection_until>2027-03</inspection_until>
    <imported_from>DE</imported_from>
    <vin>WVWZZZCDZKW123456</vin>
    <plate>123 ABC</plate>
    <equipment>
      <item>led_headlights</item>
      <item>adaptive_cruise</item>
      <item>heated_seats</item>
      <item>carplay</item>
      <item>parking_camera</item>
      <item>climate_control</item>
      <item>winter_tyres</item>
    </equipment>
    <county>Harju maakond</county>
    <city>Tallinn</city>
    <headline lang="et">Üks omanik, täielik hooldusajalugu</headline>
    <headline lang="ru">Один владелец, полная история обслуживания</headline>
    <headline lang="en">One owner, full service history</headline>
    <description lang="et">Ostetud uuena Saksamaalt, hooldatud esinduses.
Kaasa suverehvid valuvelgedel.</description>
    <description lang="ru">Куплен новым в Германии, обслуживался у официального дилера.
В комплекте летние шины на литых дисках.</description>
    <description lang="en">Bought new in Germany and serviced at the main dealer.
Summer tyres on alloy wheels are included.</description>
    <photos>
      <photo>https://media.example.ee/stock/A-1041/1.jpg</photo>
      <photo>https://media.example.ee/stock/A-1041/2.jpg</photo>
      <photo>https://media.example.ee/stock/A-1041/3.jpg</photo>
    </photos>
    <video_url>https://www.youtube.com/watch?v=aqz-KE-bpKQ</video_url>
    <agent_email>[email protected]</agent_email>
    <updated_at>2026-11-18T09:30:00+02:00</updated_at>
  </car>
  <car>
    <external_id>A-1057</external_id>
    <make>Toyota</make>
    <model>RAV4</model>
    <variant>2.5 Hybrid</variant>
    <year>2021</year>
    <month>5</month>
    <mileage_km>61500</mileage_km>
    <price>29400</price>
    <fuel>hybrid</fuel>
    <gearbox>automatic</gearbox>
    <drive>awd</drive>
    <body>suv</body>
    <power_kw>160</power_kw>
    <color>white</color>
    <owners>1</owners>
    <equipment>
      <item>navigation</item>
      <item>tow_bar</item>
      <item>keyless</item>
    </equipment>
    <county>Tartu maakond</county>
    <city>Tartu</city>
    <headline lang="et">Nelikvedu ja veokonks</headline>
    <description lang="et">Müüa heas korras linnamaastur. Hooldusraamat on kaasas.</description>
    <photos>
      <photo>https://media.example.ee/stock/A-1057/1.jpg</photo>
      <photo>https://media.example.ee/stock/A-1057/2.jpg</photo>
    </photos>
  </car>
  <car>
    <external_id>A-1063</external_id>
    <make>Škoda</make>
    <model>Octavia</model>
    <year>2017</year>
    <mileage_km>148000</mileage_km>
    <price>9800</price>
    <fuel>diesel</fuel>
    <gearbox>manual</gearbox>
    <city>Pärnu</city>
    <headline lang="et">Ökonoomne universaal</headline>
    <headline lang="en">An economical estate</headline>
    <description lang="et">Korralik pereauto.</description>
    <description lang="en">A tidy family car.</description>
    <photos>
      <photo>https://media.example.ee/stock/A-1063/1.jpg</photo>
    </photos>
  </car>
</cars>
hooga-feed-example.json Download
{
    "cars": [
        {
            "external_id": "A-1041",
            "status": "live",
            "make": "Volkswagen",
            "model": "Golf",
            "variant": "1.5 TSI Style",
            "year": 2019,
            "month": 3,
            "mileage_km": 84200,
            "price": 16900,
            "vat_deductible": true,
            "fuel": "petrol",
            "gearbox": "automatic",
            "drive": "front",
            "body": "hatchback",
            "power_kw": 110,
            "engine_cc": 1498,
            "color": "grey",
            "doors": 5,
            "seats": 5,
            "owners": 1,
            "condition": "good",
            "service_history": "full_dealer",
            "inspection_until": "2027-03",
            "imported_from": "DE",
            "vin": "WVWZZZCDZKW123456",
            "plate": "123 ABC",
            "equipment": [
                "led_headlights",
                "adaptive_cruise",
                "heated_seats",
                "carplay",
                "parking_camera",
                "climate_control",
                "winter_tyres"
            ],
            "county": "Harju maakond",
            "city": "Tallinn",
            "headline": {
                "et": "Üks omanik, täielik hooldusajalugu",
                "ru": "Один владелец, полная история обслуживания",
                "en": "One owner, full service history"
            },
            "description": {
                "et": "Ostetud uuena Saksamaalt, hooldatud esinduses.\nKaasa suverehvid valuvelgedel.",
                "ru": "Куплен новым в Германии, обслуживался у официального дилера.\nВ комплекте летние шины на литых дисках.",
                "en": "Bought new in Germany and serviced at the main dealer.\nSummer tyres on alloy wheels are included."
            },
            "photos": [
                "https://media.example.ee/stock/A-1041/1.jpg",
                "https://media.example.ee/stock/A-1041/2.jpg",
                "https://media.example.ee/stock/A-1041/3.jpg"
            ],
            "video_url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ",
            "agent_email": "[email protected]",
            "updated_at": "2026-11-18T09:30:00+02:00"
        },
        {
            "external_id": "A-1057",
            "make": "Toyota",
            "model": "RAV4",
            "variant": "2.5 Hybrid",
            "year": 2021,
            "month": 5,
            "mileage_km": 61500,
            "price": 29400,
            "fuel": "hybrid",
            "gearbox": "automatic",
            "drive": "awd",
            "body": "suv",
            "power_kw": 160,
            "color": "white",
            "owners": 1,
            "equipment": [
                "navigation",
                "tow_bar",
                "keyless"
            ],
            "county": "Tartu maakond",
            "city": "Tartu",
            "headline": {
                "et": "Nelikvedu ja veokonks"
            },
            "description": {
                "et": "Müüa heas korras linnamaastur. Hooldusraamat on kaasas."
            },
            "photos": [
                "https://media.example.ee/stock/A-1057/1.jpg",
                "https://media.example.ee/stock/A-1057/2.jpg"
            ]
        },
        {
            "external_id": "A-1063",
            "make": "Škoda",
            "model": "Octavia",
            "year": 2017,
            "mileage_km": 148000,
            "price": 9800,
            "fuel": "diesel",
            "gearbox": "manual",
            "city": "Pärnu",
            "headline": {
                "et": "Ökonoomne universaal",
                "en": "An economical estate"
            },
            "description": {
                "et": "Korralik pereauto.",
                "en": "A tidy family car."
            },
            "photos": [
                "https://media.example.ee/stock/A-1063/1.jpg"
            ]
        }
    ]
}