Siia
Siia
Eesti Русский English Latviešu Suomi Lietuvių Polski
Įdėti skelbimą Prisijungti

Agentūroms ir vystytojams

Skelbimų duomenų srautas

Laikykite skelbimus sistemoje, kurią jau naudojate, ir leiskite jai paskelbti failą. Siia skaito failą kas valandą, prideda naujus skelbimus, atnaujina pasikeitusius ir pašalina tuos, kurių nebeliko. Skelbtis Siia platformoje nemokama, importas taip pat.

Sukurti agentūros profilį XML pavyzdys JSON pavyzdys

Priimami formatai

  • Siia XML ir Siia JSON, aprašyti šiame puslapyje.
  • REDE XML 0.93 versija (schemos ekfl.ee/schema dokumentas <Objects>), su urn:REDE/0.93 vardų erdve arba be jos. Suprantama ir kv.ee laukų sąrašo rašyba.

Jau siunčiate skelbimus į kv.ee?

kv.ee importuoja skelbimus REDE XML formatu (Real Estate Data Exchange), tai 2007 m. Estijos standartas. Siia skaito tą patį formatą, todėl jūsų sistemai nereikia naujo eksporto: ji turi tik paskelbti objektus, kuriuos jau ruošia kv.ee, kaip vieną <Objects> dokumentą https adresu. Nurodykite šį adresą skirtuke „Importas“ arba vieną kartą įkelkite failą išbandymui. Formatas atpažįstamas automatiškai, o šio puslapio taisyklės taikomos taip pat.

kv.ee objektus iš jūsų sistemos gauna po vieną (getObjectById). Siia jų reikia viename faile. Paprašykite savo sistemos tiekėjo REDE eksporto pastoviu adresu; tai tie patys duomenys. Jei tai neįmanoma, rašykite [email protected].

Kaip skaitomas REDE failas

  • Importuojami tik objektai, kurių status yra active, ir tik kai visible yra all arba jo nėra. Archyvuotas, ištrintas, parduotas ar išnuomotas objektas laikomas palikusiu duomenų srautą.
  • Objektas, siūlomas ir parduoti, ir nuomoti, tampa dviem skelbimais. Antrasis gauna objekto identifikatorių su priedu „-rent“ arba „-sale“.
  • Kaina turi būti eurais ir vieša. Namo ar buto numeris, pažymėtas kaip paslėptas, nerodomas.
  • Aprašymas imamas iš sandorio info tekstų (est, rus, eng, lav). Plotai arais ar hektarais paverčiami m².
  • Perimami tipas, būklė, statybinė medžiaga, energinio naudingumo klasė, kambariai, aukštai, balkonai, renovacijos metai, nuotraukos, vaizdo įrašai ir koordinatės. Parinktys, neturinčios atitikmens Siia platformoje, praleidžiamos.
  • Agentas susiejamas pagal el. paštą, kai faile yra ir brokerių įrašai (<Broker> su <email>). Kitaip skelbimai pasirašomi profilio savininko vardu.
  • Garažai, stovėjimo vietos ir sandėliukai bei objektai už Estijos ribų kol kas praleidžiami.

Jau kuriate failą kitam portalui?

Atsiųskite mums failą, kurį jau kuriate, ir pridėsime jo palaikymą. Importas sukurtas taip, kad naujas formatas būtų vienas mažas adapteris mūsų pusėje, o jūsų pusėje nieko keisti nereikėtų. Rašykite [email protected].

Kaip tai veikia

  1. 01

    Sukurkite profilį

    Prisijunkite ir sukurkite agentūros ar vystytojo profilį. Pakvieskite agentus el. paštu, kad skelbimai būtų pasirašyti jų vardais.

  2. 02

    Pridėkite duomenų srauto adresą

    Skirtuke „Importas“ įveskite savo failo https adresą arba vieną kartą įkelkite failą išbandymui.

  3. 03

    Peržiūrėkite

    Siia perskaito duomenų srautą nieko neskelbdama ir parodo, kiek skelbimų rado, pirmuosius dešimt taip, kaip juos suprato, ir kiekvieno skelbimo pastabas.

  4. 04

    Pradėkite importą

    Niekas netampa aktyvu, kol nepatvirtinate. Nuo tada duomenų srautas skaitomas kas valandą.

Struktūra

Vienas dokumentas su visais skelbimais, kuriuos norite turėti Siia platformoje, UTF-8 koduote. XML šakninis elementas yra <listings> su vienu <listing> kiekvienam būstui. JSON tai objektas su masyvu „listings“. Laukų pavadinimai abiem atvejais tie patys.

Laukai

Laukas Privalomas Kas tai
external_id taip Jūsų paties skelbimo identifikatorius. Jis turi likti toks pat visą skelbimo gyvavimo laiką: taip Siia žino, kurį skelbimą atnaujinti.
deal taip sale arba rent.
type taip apartment, house, land, commercial arba summer_home.
price taip Sveikaisiais eurais. Mėnesio nuoma, kai deal yra rent.
address taip Arba dalys (county, city, district, street, house, unit), arba viena eilutė, pavyzdžiui, „Vabriku 12-5, Tallinn“. Iš dalių būtini bent miestas ir gatvė.
coordinates ne lat ir lng WGS84 sistemoje. Jei jų nėra, Siia nustato vietą pagal adresą oficialiame adresų registre.
area taip Plotas m². Sklypams nereikalingas.
plot_area sklypams Sklypo plotas m².
rooms, bedrooms, bathrooms ne Sveikieji skaičiai.
floor, floors_total ne Būsto aukštas ir pastato aukštų skaičius.
built_year, renovated_year ne Keturženkliai metai.
condition ne Žr. sąrašus žemiau.
energy_label ne Nuo A iki H.
material ne Žr. sąrašus žemiau.
balcony_area ne m².
features ne Žemiau nurodytų reikšmių sąrašas.
headline ne Trumpa antraštė kiekviena kalba (et, ru, en), iki 80 simbolių.
description taip Tekstas kiekviena kalba (et, ru, en), iki 2 000 simbolių. Bent viena kalba. Paprastas HTML paverčiamas paprastu tekstu.
agent_email ne Skelbimą tvarkančio agento el. paštas. Jei jis sutampa su jūsų profilio nariu, skelbimas pasirašomas jo vardu, kitaip profilio savininko vardu.
photos taip JPG, PNG arba WebP failų https adresai ta tvarka, kuria jie turi būti rodomi, pirmasis yra viršelis. Iki 40, iki 25 MB kiekvienas.
floor_plan ne Paveikslėlio arba PDF https adresas.
video_url ne YouTube arba Matterport nuoroda.
cadastral_number ne Sklypo kadastro numeris.
updated_at ne Kada paskutinį kartą pakeitėte skelbimą, ISO 8601. Jūsų pačių informacijai: Siia turinį lygina pati.

Priimamos reikšmės

Rašykite reikšmes taip, kaip nurodyta žemiau. Suprantami ir įprasti estiški žodžiai (korter, maja, müük, üür), o nebūtina reikšmė, kurios nežinome, paliekama tuščia su pastaba žurnale, užuot atmetus skelbimą.

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

Taisyklės

  • Priimami tik https adresai, tiek duomenų srautui, tiek nuotraukoms. Duomenų srautas gali būti iki 20 MB ir 5000 skelbimų, turi atsakyti per 20 s ir gali nukreipti ne daugiau kaip 3 kartų.
  • Niekas neskelbiama, kol profilio savininkas nepamato peržiūros ir nepaspaudžia „Pradėti importą“. Šis patvirtinimas užfiksuojamas kaip jūsų leidimas skelbti turinį.
  • Skelbimas sukuriamas iš karto aktyvus. Kad būtų priimtas, jam reikia identifikatoriaus, sandorio, tipo, kainos, adreso, ploto, aprašymo ir bent vienos nuotraukos; kiti praleidžiami ir nurodomi žurnale su priežastimi.
  • Skelbimai susiejami pagal external_id. Pasikeitęs skelbimas atnaujinamas, nepakitęs paliekamas ramybėje, o atsisiunčiamos tik naujos nuotraukos.
  • Nuotrauka, kurios nepavyksta atsisiųsti, praleidžiama ir bandoma dar kartą kito paleidimo metu. Skelbimas vis tiek paskelbiamas.
  • Skelbimas, kurio duomenų sraute nebėra, pašalinamas tik tada, kai jo nėra 2 sėkminguose paleidimuose iš eilės. Jei jis sugrįžta, paskelbiamas iš naujo.
  • Jei duomenų srauto perskaityti nepavyksta arba jis tuščias, niekas nekeičiama: jūsų skelbimai lieka tokie, kokie buvo.
  • Po nesėkmių duomenų srautas bandomas dar kartą po 1 h, 3 h, 12 h, 24 h. Po trečios nesėkmės iš eilės profilio savininkas gauna vieną el. laišką.
  • Importas niekada neliečia skelbimų, kurie Siia platformoje įvesti rankiniu būdu.

Pilnas pavyzdys

Trys skelbimai: pilnas įrašas, trumpiausias priimamas įrašas ir žemės sklypas.

siia-feed-example.xml Atsisiųsti 
<?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 Atsisiųsti 
{
  "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"
    }
  ]
}

Naujos statybos projekto kainoraštis

Vystytojas gali laikyti projekto kainoraštį skaičiuoklėje ir pateikti jos nuorodą projekto puslapyje, skiltyje Butai ir kainos. Priimama: CSV arba TSV, Google skaičiuoklė (įprasta bendrinimo nuoroda visiems, turintiems nuorodą, arba Failas, Bendrinti, Paskelbti internete kaip CSV) arba JSON su objektų masyvu, kurio raktai yra stulpelių pavadinimai. Viena eilutė vienam butui, pirmoje eilutėje nurodomi stulpelių pavadinimai.

Laukas Privalomas Kas tai
code taip Buto kodas, unikalus projekte, pavyzdžiui, A-12. Butai susiejami pagal jį.
rooms taip Kambarių skaičius.
area_m2 taip Plotas m². Dešimtainis kablelis arba taškas.
floor taip Aukštas, 0 reiškia pirmą (žemės) aukštą.
balcony_m2 ne Balkonas arba terasa m².
price taip Kaina eurais. Tarpai ir euro ženklas nepaisomi.
status ne available, reserved arba sold. Taip pat vaba, müügis, broneeritud, müüdud, свободна, бронь, продана. Tuščia reiškia laisvą; bet koks kitas žodis eilutę praleidžia.
plan_url ne https nuoroda į buto planą.

Tinka ir estiški stulpelių pavadinimai: kood, tube, pind, korrus, rõdu, hind, staatus, plaan.

  • Tikrinti parodo, kiek butų būtų pridėta, pakeista ar trūksta, ir kurių eilučių nepavyksta perskaityti. Kol nepaspaudžiate Pradėti sinchronizavimą, niekas nesikeičia.
  • Po to nuoroda skaitoma kas valandą. Neperskaitoma eilutė praleidžiama, likusios sinchronizuojamos. Jei skaičiuoklės atsisiųsti nepavyksta, niekas nekeičiama.
  • Butas, kurio nėra skaičiuoklėje, pažymimas parduotu, kai jo nėra 2 sinchronizavimus iš eilės. Butai niekada netrinami.
  • Pirkėjo Siia platformoje padaryta rezervacija galioja tol, kol trunka, net jei skaičiuoklėje nurodyta laisvas. Parduota skaičiuoklėje ją užbaigia.
  • Ne daugiau kaip 1 000 eilučių ir 2 MB. Po nesėkmių bandome dar kartą po 1 h, 3 h, 12 h, 24 h; po 3 nesėkmių iš eilės profilio savininkas gauna vieną el. laišką.
siia-price-list-example.csv CSV pavyzdys 
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,