For dealers and their IT partners
Listing API
Publish, update and take down your cars on Hooga from your own stock system the moment they change, instead of waiting for the hourly read of the feed. Free, like listing itself.
Access is given on request
Anyone can read this description, but the API works only for dealers we have switched it on for. The owner of a dealer profile asks for access on the API tab of the dealer page.
How to get access
-
01
Create a dealer profile
Sign in and create the profile of your dealership. It is free and works at once.
-
02
Request access
On the API tab of the dealer page, tell us which system you keep your stock in and send the request.
-
03
We switch the API on
We look at the request and answer by e-mail. Once the API is on, the API tab lets you create keys.
-
04
Create a key
The owner creates a key and gives it to whoever connects your system. The key is shown once.
What the API does and does not do
- It works only with your own cars: publish, update, take down and check them.
- It has no search and returns nothing about other sellers' cars. It is not a way to read the site.
- A key belongs to the dealer, not to a person. Only the owner of the profile creates and revokes keys, at most 5 at a time.
- A key is shown once, Hooga keeps only its fingerprint, and every key stops working after 365 days.
Requests
All addresses start with https://hooga.ee/api/agency/v1. Every request carries the header Authorization: Bearer <key>. Answers are JSON.
PUT/listings/{external_id}- Publish a new car or replace an existing one. The body is one car with the fields of the feed; external_id is your own number for it and goes in the address. Checked at once; photos and publishing follow within a minute.
DELETE/listings/{external_id}- Take the car off the site. Send {"reason": "sold"} when it was sold. Sending it again with PUT brings it back.
GET/listings/{external_id}- The state of one car and the result of the last change, with the reasons if it failed. Kept for 14 days.
GET/listings- Your cars that have an external_id, newest change first, 100 per page. Pass next_cursor as ?cursor= for the next page.
Examples
Publish or update a car. car.json holds one car:
curl -X PUT https://hooga.ee/api/agency/v1/listings/A-1041 \
-H 'Authorization: Bearer YOUR_KEY' \
-H 'Content-Type: application/json' \
-d @car.json{
"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]"
}The car passed the checks and is on its way:
{
"external_id": "A-1041",
"state": "queued",
"message": "Accepted. The listing is published or updated in a moment; read the result with GET on the same address.",
"warnings": []
}Something required is missing. Nothing was changed:
{
"error": {
"code": "invalid_listing",
"message": "The listing was not accepted. Nothing was changed."
},
"problems": [
{
"level": "error",
"code": "missing_price",
"detail": null,
"message": "The price is missing or not a number"
}
]
}Check the result:
curl https://hooga.ee/api/agency/v1/listings/A-1041 \
-H 'Authorization: Bearer YOUR_KEY'{
"external_id": "A-1041",
"listing": {
"external_id": "A-1041",
"title": "Volkswagen Golf 1.5 TSI Style · 2019",
"status": "live",
"is_public": true,
"url": "https://hooga.ee/cars/volkswagen-golf-15-tsi-style-2019-4821",
"price": 16900,
"updated_at": "2026-11-18T10:02:11+02:00"
},
"last_change": {
"state": "done",
"result": "created",
"accepted_at": "2026-11-18T10:01:58+02:00",
"finished_at": "2026-11-18T10:02:11+02:00"
}
}The car was sold:
curl -X DELETE https://hooga.ee/api/agency/v1/listings/A-1041 \
-H 'Authorization: Bearer YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"reason": "sold"}'Answer codes
200- Done, or here is what you asked for.
202- Accepted. Read the result with GET.
400- The body is not one car as a JSON object.
401- No key, or a wrong, revoked or expired key.
403- The API is not switched on for this dealer.
404- You have no car with this external_id.
409- Hooga has taken this listing down. It cannot be published again.
413- The request is too large. Send photos as links.
422- The car was not accepted. The answer lists what to fix.
429- Too many requests. Wait for the number of seconds in Retry-After.
Rules and limits
- Fields, allowed values and checks are the same as in the feed. The feed page describes every field.
- Photos are links that Hooga downloads (https only), in the order you send them.
- At most 120 requests per minute per key and 3000 changes per hour per dealer; 120 requests per minute per address.
- A request body is at most 256 KB.
- Cars you added by hand on Hooga have no external_id, and the API never touches them.
- Send a car through the feed or through the API, not both: once a feed has listed a car, the car leaves the site when it leaves that feed.