Siia
Siia
Eesti Русский English Latviešu Suomi Lietuvių Polski
Lisa kuulutus Logi sisse

Büroodele ja arendajatele

Kuulutuste fail

Hoia kuulutusi süsteemis, mida juba kasutad, ja lase sel avaldada fail. Siia loeb faili iga tund, lisab uued kuulutused, uuendab muutunud ja võtab maha need, mida failis enam pole. Kuulutamine Siia portaalis on tasuta ja import samuti.

Loo büroo profiil XML-näidis JSON-näidis

Sobivad vormingud

  • Siia XML ja Siia JSON, kirjeldatud sellel lehel.
  • REDE XML versioon 0.93 (skeemi <Objects> dokument, ekfl.ee/schema), nimeruumiga urn:REDE/0.93 või ilma. Arusaadavad on ka kv.ee enda väljade loendi kirjapildid.

Saadate kuulutusi juba kv.ee-sse?

kv.ee impordib kuulutusi REDE XML-ina (Real Estate Data Exchange), mis on 2007. aasta Eesti standard. Siia loeb sama vormingut, nii et teie süsteem ei vaja uut eksporti: piisab, kui ta avaldab kv.ee jaoks valmistatud objektid ühe <Objects> dokumendina https aadressil. Sisestage see aadress Impordi vahekaardil või laadige fail proovimiseks üks kord üles. Vorming tuntakse ära automaatselt ja sellel lehel kirjeldatud reeglid kehtivad samamoodi.

kv.ee küsib objekte teie süsteemist ükshaaval (getObjectById). Siia vajab neid ühes failis. Küsige oma süsteemi tarnijalt REDE eksporti kindlal aadressil, andmed on samad. Kui see ei õnnestu, kirjutage [email protected].

Kuidas REDE faili loetakse

  • Imporditakse ainult objektid staatusega active ja ainult siis, kui visible on all või puudub. Arhiveeritud, kustutatud, müüdud või üüritud objekt loetakse voost lahkunuks.
  • Müügiks ja üürile pakutud objektist saab kaks kuulutust. Teine neist saab objekti tunnuse lõppu "-rent" või "-sale".
  • Hind peab olema eurodes ja avalik. Peidetuks märgitud maja- või korterinumbrit ei näidata.
  • Kirjeldus tuleb tehingu info-tekstidest (est, rus, eng, lav). Aarides või hektarites pind arvutatakse ruutmeetriteks.
  • Üle võetakse tüüp, seisukord, ehitusmaterjal, energiamärgis, toad, korrused, rõdud, renoveerimise aastad, fotod, videod ja koordinaadid. Lisavõimalused, millele Siia portaalis vastet pole, jäetakse välja.
  • Maakler leitakse e-posti järgi, kui failis on ka maaklerite kirjed (<Broker> koos <email>). Muidu lähevad kuulutused profiili omaniku nimele.
  • Garaažid, parkimiskohad ja panipaigad ning väljaspool Eestit asuvad objektid jäetakse praegu välja.

Kas koostad juba faili mõnele teisele portaalile?

Saada meile fail, mida sa juba koostad, ja lisame selle toe. Import on ehitatud nii, et uus vorming tähendab meie poolel üht väikest adapterit ja sinu poolel ei muutu midagi. Kirjuta aadressil [email protected].

Kuidas see käib

  1. 01

    Loo profiil

    Logi sisse ja loo büroo või arendaja profiil. Kutsu maaklerid e-posti teel, et kuulutused saaksid nende nime.

  2. 02

    Lisa faili aadress

    Sisesta vahelehel Import oma faili https-aadress või laadi proovimiseks fail üks kord üles.

  3. 03

    Vaata eelvaadet

    Siia loeb faili midagi avaldamata ja näitab, mitu kuulutust leiti, esimest kümmet nii, nagu neist aru saadi, ja iga kuulutuse märkusi.

  4. 04

    Alusta importi

    Alles sinu kinnituse järel avaldatakse midagi. Sealt edasi loetakse faili iga tund.

Ülesehitus

Üks UTF-8 dokument kõigi kuulutustega, mida Siia portaalis näidata soovid. XML-is on juurelement <listings> ja iga kodu kohta üks <listing>. JSON-is on see objekt massiiviga "listings". Väljade nimed on mõlemas samad.

Väljad

Väli Kohustuslik Selgitus
external_id jah Kuulutuse tunnus sinu süsteemis. See peab püsima sama kogu kuulutuse eluaja: nii teab Siia, millist kuulutust uuendada.
deal jah sale (müük) või rent (üür).
type jah apartment, house, land, commercial või summer_home.
price jah Täiseurodes. Üüri puhul kuuüür.
address jah Kas osadena (county, city, district, street, house, unit) või ühe reana, näiteks "Vabriku 12-5, Tallinn". Osade puhul on vaja vähemalt linna ja tänavat.
coordinates ei lat ja lng WGS84 süsteemis. Kui need puuduvad, leiab Siia asukoha aadressi järgi ametlikust aadressiregistrist.
area jah Pindala ruutmeetrites. Maa puhul pole vaja.
plot_area maa puhul Krundi pindala ruutmeetrites.
rooms, bedrooms, bathrooms ei Täisarvud.
floor, floors_total ei Kodu korrus ja hoone korruste arv.
built_year, renovated_year ei Neljakohalised aastaarvud.
condition ei Vaata loendeid allpool.
energy_label ei A kuni H.
material ei Vaata loendeid allpool.
balcony_area ei Ruutmeetrites.
features ei Loend allpool toodud väärtustest.
headline ei Lühike pealkiri keele kaupa (et, ru, en), kuni 80 tähemärki.
description jah Tekst keele kaupa (et, ru, en), kuni 2000 tähemärki. Vähemalt ühes keeles. Lihtne HTML muudetakse tavatekstiks.
agent_email ei Kuulutusega tegeleva maakleri e-post. Kui see kattub sinu profiili liikmega, saab kuulutus tema nime, muidu profiili omaniku nime.
photos jah JPG-, PNG- või WebP-failide https-aadressid näitamise järjekorras, esimene on kaanepilt. Kuni 40 fotot, igaüks kuni 25 MB.
floor_plan ei Pildi või PDF-i https-aadress.
video_url ei YouTube'i või Matterporti link.
cadastral_number ei Katastriüksuse tunnus.
updated_at ei Millal kuulutust viimati muutsid, ISO 8601. Sinu enda jaoks: Siia võrdleb sisu ennast.

Lubatud väärtused

Kirjuta väärtused nii, nagu allpool. Mõistame ka tavalisi eestikeelseid sõnu (korter, maja, müük, üür). Vabatahtlik väärtus, mida me ei tunne, jäetakse tühjaks ja logisse tehakse märkus, kuulutust tagasi ei lükata.

deal
sale rent
type
apartment house land commercial summer_home
condition
new_build renovated good needs_renovation
energy_label
A B C D E F G H
material
stone wood panel log
features
balcony terrace lift parking storage sauna fireplace furnished bicycle_room underfloor_heating fibre

Reeglid

  • Lubatud on ainult https-aadressid, nii faili kui ka fotode jaoks. Fail võib olla kuni 20 MB ja sisaldada kuni 5000 kuulutust, peab vastama 20 sekundi jooksul ja võib ümber suunata kuni 3 korda.
  • Midagi ei avaldata enne, kui profiili omanik on eelvaadet näinud ja vajutanud "Alusta importi". See kinnitus salvestatakse sinu loana sisu avaldada.
  • Kuulutus luuakse kohe avalikuna. Selleks on vaja tunnust, tehingut, liiki, hinda, aadressi, pindala, kirjeldust ja vähemalt üht fotot. Teised jäetakse vahele ja logis on kirjas põhjus.
  • Kuulutused viiakse kokku external_id järgi. Muutunud kuulutus uuendatakse, muutmata kuulutust ei puudutata ja alla laaditakse ainult uued fotod.
  • Foto, mida ei õnnestu alla laadida, jäetakse vahele ja proovitakse järgmisel korral uuesti. Kuulutus avaldatakse ikkagi.
  • Kuulutus, mida failis enam pole, võetakse maha alles siis, kui see on puudunud 2 järjestikusest õnnestunud lugemisest. Kui see tuleb tagasi, avaldatakse see uuesti.
  • Kui faili ei saa lugeda või see on tühi, ei muudeta mitte midagi: kuulutused jäävad nii, nagu need olid.
  • Tõrgete järel proovitakse faili uuesti 1 h, 3 h, 12 h, 24 h pärast. Kolmanda järjestikuse tõrke järel saab profiili omanik ühe e-kirja.
  • Siia portaalis käsitsi sisestatud kuulutusi import kunagi ei puuduta.

Täielik näidis

Kolm kuulutust: täielik kirje, lühim kirje, mis vastu võetakse, ja maatükk.

siia-feed-example.xml Laadi alla 
<?xml version="1.0" encoding="UTF-8"?>
<!-- Siia listing feed, version 1. Documentation: https://siia.ee/for-agents/feed -->
<listings version="1" generated_at="2026-11-13T08:00:00+02:00">

  <!-- A full entry: address in parts, coordinates, three languages. -->
  <listing>
    <external_id>KB-10231</external_id>
    <deal>sale</deal>
    <type>apartment</type>
    <price currency="EUR">189000</price>
    <address>
      <county>Harju maakond</county>
      <city>Tallinn</city>
      <district>Kalamaja</district>
      <street>Vabriku</street>
      <house>12</house>
      <unit>5</unit>
    </address>
    <coordinates lat="59.447310" lng="24.731420"/>
    <area>54.3</area>
    <rooms>2</rooms>
    <bedrooms>1</bedrooms>
    <bathrooms>1</bathrooms>
    <floor>3</floor>
    <floors_total>5</floors_total>
    <built_year>1962</built_year>
    <renovated_year>2021</renovated_year>
    <condition>renovated</condition>
    <energy_label>C</energy_label>
    <material>stone</material>
    <balcony_area>4.5</balcony_area>
    <features>
      <feature>balcony</feature>
      <feature>storage</feature>
      <feature>fibre</feature>
    </features>
    <headline lang="et">Renoveeritud kahetoaline korter Kalamajas</headline>
    <headline lang="ru">Двухкомнатная квартира после ремонта в Каламая</headline>
    <headline lang="en">Renovated two-room apartment in Kalamaja</headline>
    <description lang="et"><![CDATA[Valgusküllane korter vaikse sisehoovi poole. Uus elektrisüsteem ja torustik, rõdu õhtupäikesega.

Trammipeatus on kolme minuti kaugusel.]]></description>
    <description lang="ru"><![CDATA[Светлая квартира с окнами в тихий двор. Новая электрика и трубы, балкон на вечернее солнце.]]></description>
    <description lang="en"><![CDATA[A bright apartment facing a quiet courtyard. New wiring and plumbing, a balcony with evening sun.]]></description>
    <agent_email>[email protected]</agent_email>
    <photos>
      <photo>https://media.example.ee/listings/10231/01.jpg</photo>
      <photo>https://media.example.ee/listings/10231/02.jpg</photo>
      <photo>https://media.example.ee/listings/10231/03.jpg</photo>
    </photos>
    <floor_plan>https://media.example.ee/listings/10231/plan.png</floor_plan>
    <updated_at>2026-11-12T16:40:00+02:00</updated_at>
  </listing>

  <!-- The shortest entry that is accepted: one address line (Siia looks up the rest), one language. -->
  <listing>
    <external_id>KB-10244</external_id>
    <deal>rent</deal>
    <type>apartment</type>
    <price currency="EUR">650</price>
    <address>
      <line>Sõpruse pst 202, Tallinn</line>
    </address>
    <area>38</area>
    <rooms>1</rooms>
    <description lang="et">Möbleeritud ühetoaline korter Mustamäel. Vaba alates detsembrist.</description>
    <photos>
      <photo>https://media.example.ee/listings/10244/01.jpg</photo>
    </photos>
    <updated_at>2026-11-10T09:15:00+02:00</updated_at>
  </listing>

  <!-- Land: plot_area instead of area. -->
  <listing>
    <external_id>KB-10250</external_id>
    <deal>sale</deal>
    <type>land</type>
    <price currency="EUR">42000</price>
    <address>
      <county>Tartu maakond</county>
      <city>Kambja vald</city>
      <district>Kulli küla</district>
      <street>Kuuse</street>
    </address>
    <coordinates lat="58.262100" lng="26.705300"/>
    <plot_area>1850</plot_area>
    <cadastral_number>28201:001:0345</cadastral_number>
    <headline lang="et">Elamumaa krunt Kulli külas</headline>
    <description lang="et">Tasane krunt asfalttee ääres, elekter ja vesi krundi piiril.</description>
    <description lang="en">A level residential plot by a paved road, electricity and water at the boundary.</description>
    <agent_email>[email protected]</agent_email>
    <photos>
      <photo>https://media.example.ee/listings/10250/01.jpg</photo>
      <photo>https://media.example.ee/listings/10250/02.jpg</photo>
    </photos>
    <updated_at>2026-11-01T12:00:00+02:00</updated_at>
  </listing>

</listings>
siia-feed-example.json Laadi alla 
{
  "version": 1,
  "generated_at": "2026-11-13T08:00:00+02:00",
  "listings": [
    {
      "external_id": "KB-10231",
      "deal": "sale",
      "type": "apartment",
      "price": 189000,
      "address": {
        "county": "Harju maakond",
        "city": "Tallinn",
        "district": "Kalamaja",
        "street": "Vabriku",
        "house": "12",
        "unit": "5"
      },
      "coordinates": { "lat": 59.44731, "lng": 24.73142 },
      "area": 54.3,
      "rooms": 2,
      "bedrooms": 1,
      "bathrooms": 1,
      "floor": 3,
      "floors_total": 5,
      "built_year": 1962,
      "renovated_year": 2021,
      "condition": "renovated",
      "energy_label": "C",
      "material": "stone",
      "balcony_area": 4.5,
      "features": ["balcony", "storage", "fibre"],
      "headline": {
        "et": "Renoveeritud kahetoaline korter Kalamajas",
        "ru": "Двухкомнатная квартира после ремонта в Каламая",
        "en": "Renovated two-room apartment in Kalamaja"
      },
      "description": {
        "et": "Valgusküllane korter vaikse sisehoovi poole. Uus elektrisüsteem ja torustik, rõdu õhtupäikesega.\n\nTrammipeatus on kolme minuti kaugusel.",
        "ru": "Светлая квартира с окнами в тихий двор. Новая электрика и трубы, балкон на вечернее солнце.",
        "en": "A bright apartment facing a quiet courtyard. New wiring and plumbing, a balcony with evening sun."
      },
      "agent_email": "[email protected]",
      "photos": [
        "https://media.example.ee/listings/10231/01.jpg",
        "https://media.example.ee/listings/10231/02.jpg",
        "https://media.example.ee/listings/10231/03.jpg"
      ],
      "floor_plan": "https://media.example.ee/listings/10231/plan.png",
      "updated_at": "2026-11-12T16:40:00+02:00"
    },
    {
      "external_id": "KB-10244",
      "deal": "rent",
      "type": "apartment",
      "price": 650,
      "address": "Sõpruse pst 202, Tallinn",
      "area": 38,
      "rooms": 1,
      "description": { "et": "Möbleeritud ühetoaline korter Mustamäel. Vaba alates detsembrist." },
      "photos": ["https://media.example.ee/listings/10244/01.jpg"],
      "updated_at": "2026-11-10T09:15:00+02:00"
    },
    {
      "external_id": "KB-10250",
      "deal": "sale",
      "type": "land",
      "price": 42000,
      "address": {
        "county": "Tartu maakond",
        "city": "Kambja vald",
        "district": "Kulli küla",
        "street": "Kuuse"
      },
      "coordinates": { "lat": 58.2621, "lng": 26.7053 },
      "plot_area": 1850,
      "cadastral_number": "28201:001:0345",
      "headline": { "et": "Elamumaa krunt Kulli külas" },
      "description": {
        "et": "Tasane krunt asfalttee ääres, elekter ja vesi krundi piiril.",
        "en": "A level residential plot by a paved road, electricity and water at the boundary."
      },
      "agent_email": "[email protected]",
      "photos": [
        "https://media.example.ee/listings/10250/01.jpg",
        "https://media.example.ee/listings/10250/02.jpg"
      ],
      "updated_at": "2026-11-01T12:00:00+02:00"
    }
  ]
}

Uusarendusprojekti hinnakiri

Arendaja võib hoida projekti hinnakirja tabelis ja anda selle lingi projekti lehel jaotises Korterid ja hinnad. Sobivad CSV ja TSV, Google'i tabel (tavaline jagamislink kõigile, kellel on link, või Fail, Jaga, Avalda veebis CSV-na) ning JSON, kus on objektide massiiv veergude nimedega võtmetena. Üks rida korteri kohta, esimene rida nimetab veerud.

Väli Kohustuslik Selgitus
code jah Korteri kood, projektis ainulaadne, näiteks A-12. Selle järgi korterid seotakse.
rooms jah Tubade arv.
area_m2 jah Pind m². Komakoht komaga või punktiga.
floor jah Korrus, esimene korrus on 0.
balcony_m2 ei Rõdu või terrass m².
price jah Hind eurodes. Tühikud ja euromärk ei sega.
status ei available, reserved või sold. Ka vaba, müügis, broneeritud, müüdud, свободна, бронь, продана. Tühi tähendab vaba; muu sõna jätab rea välja.
plan_url ei https-link korteri plaanile.

Sobivad ka eestikeelsed veergude nimed: kood, tube, pind, korrus, rõdu, hind, staatus, plaan.

  • Kontroll näitab, mitu korterit lisanduks, muutuks või puudub, ja milliseid ridu ei saa lugeda. Enne nuppu Alusta sünkroonimist ei muutu midagi.
  • Seejärel loetakse linki iga tund. Rida, mida ei saa lugeda, jäetakse välja, ülejäänu sünkroonitakse. Kui tabelit ei saa alla laadida, ei muutu midagi.
  • Korter, mida tabelis pole, märgitakse müüduks, kui see puudub 2 korda järjest. Kortereid ei kustutata kunagi.
  • Ostja broneering Siia portaalis kehtib oma aja, ka siis, kui tabelis on vaba. Tabelis märgitud müüdud lõpetab selle.
  • Kuni 1 000 rida ja 2 MB. Pärast viga proovime uuesti 1 h, 3 h, 12 h, 24 h pärast; pärast 3 viga järjest saab profiili omanik ühe kirja.
siia-price-list-example.csv CSV-näidis 
code,rooms,area_m2,floor,balcony_m2,price,status,plan_url
A-1,1,31.5,0,,149000,available,https://example.ee/plans/a-1.pdf
A-2,2,48.5,1,5.2,219000,available,https://example.ee/plans/a-2.pdf
A-3,2,50.0,1,5.2,226000,reserved,
A-4,3,72.4,2,8.0,315000,sold,https://example.ee/plans/a-4.pdf
B-1,4,96.0,3,12.5,429000,available,