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
-
01
Publish the file
Your stock system writes every car that is for sale into one file, XML or JSON, at an https address.
-
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.
-
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-
livepausedsold fuel-
petroldieselhybridplugin_hybridelectricgas gearbox-
manualautomatic drive-
frontrearawd body-
hatchbacksedanestatesuvcoupeconvertibleminivanpickupvan color-
whiteblackgreysilverblueredgreenbrownbeigeyelloworangeother condition-
excellentgoodfairneeds_work service_history-
full_dealerfull_independentpartialnone equipment-
led_headlightsadaptive_cruisecruise_controlheated_seatsheated_steering_wheelcarplaynavigationparking_sensorsparking_cameratow_barsunroofleatherkeylessdigital_cockpitclimate_controlparking_heaterwinter_tyresroof_rails imported_from-
DESEFILVLTPLNLBEFRITESATCHDKNOGBUSJPKR county-
Harju maakondHiiu maakondIda-Viru maakondJõgeva maakondJärva maakondLääne maakondLääne-Viru maakondPõlva maakondPärnu maakondRapla maakondSaare maakondTartu maakondValga maakondViljandi maakondVõ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 APIA complete example
Three cars: the first with every field, the last with only the required ones. Both files hold the same cars.
<?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>
{
"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"
]
}
]
}