GlovatoReal · XML Feed

Specifikace XML feedu – FULL schema (real_estate_ads + property_images)

Tato stránka popisuje kompletní datový model GlovatoReal pro import/export inzerátů. Jedná se o full schema 1:1 se strukturou tabulky real_estate_ads a doplňkovou tabulkou property_images.

Sloupce jsou rozdělené do tematických sekcí. Pro externí XML feedy doporučujeme vždy vyplnit minimálně pole označená jako doporučené / klíčové. Pole označená jako systémové jsou interní a GlovatoReal je obvykle generuje samo.

Poznámka: Tento dokument je určen pro vývojáře realitních kanceláří, CRM systémů a integrátorů, kteří chtějí napojit vlastní XML feed do GlovatoReal. Pokud si nejste jistí mapováním, kontaktujte podporu GlovatoReal.

Sekce 1 – Identifikace a zdrojová data (sloupce 1–6)

# Sloupec (DB) Datový typ Povinné ve feedu Popis Formát / hodnoty Příklad
1 id int (PK, AUTO_INCREMENT) systémové Interní jedinečné ID inzerátu v GlovatoReal. Při importu z XML se nemusí posílat, systém generuje vlastní hodnotu. Celé číslo > 0. Při importu ignorováno, pokud je uvedeno. 12345
2 scraped_id int volitelné ID záznamu v tabulce se scrapovanými inzeráty (např. scraped_real_estate_ads.id). Pro ruční XML feedy obvykle není potřeba, spíše pro interní migrace. Celé číslo nebo null. 9876
3 source_name varchar(50) volitelné Název zdroje inzerátu. U scrapingu např. soccer_reality, krska_reality; u kanceláří lze použít název softwaru nebo kanceláře, odkud feed pochází. Krátký identifikátor zdroje, bez diakritiky doporučeno. soccer_reality, moje_kancelar_xml
4 source_url varchar(500) volitelné Původní URL detailu inzerátu na zdrojovém webu (pokud existuje jiný portál nebo systém, odkud data pocházejí). Plná URL adresa, včetně https://. https://www.nazev-portalu.cz/detail/12345
5 external_url varchar(500) volitelné Doplňková externí URL související s inzerátem – např. alternativní detail na webu kanceláře, speciální landing page nebo stránka developera. Plná URL adresa, včetně https://. https://www.makler-janak.cz/nabidka/byt-2kk-brno
6 scrape_status enum('new','updated','missing','manual') systémové Stav scrapovaného záznamu (určeno pro interní scraping pipeline GlovatoReal). U ručních XML feedů není potřeba vyplňovat. Povoleno: new – nově nalezený záznam
updated – aktualizovaný záznam
missing – zdroj už záznam neobsahuje
manual – ručně spravovaný záznam
manual

Sekce 2 – Typ transakce a základní popis (sloupce 7–18)

# Sloupec (DB) Datový typ Povinné ve feedu Popis Formát / hodnoty Příklad
7 transaction_type enum('sale','rent') doporučené / klíčové Typ transakce – zda se jedná o prodej nebo pronájem. sale – prodej
rent – pronájem
sale
8 title varchar(255) doporučené / klíčové Titulek inzerátu, zobrazuje se v kartách, detailech a ve vyhledávání. Krátký a výstižný marketingový název. Max. 255 znaků, doporučeno uvést dispozici, typ a lokalitu. Prodej bytu 2+kk, 54 m², Praha 4 – Braník
9 description text doporučené / klíčové Plný textový popis nemovitosti. Může obsahovat HTML (odstavce, odrážky). Delší text, UTF-8, HTML tagy povoleny (p
ul li atd.).
Byt se nachází ve 3. NP zatepleného panelového domu...
10 price decimal(12,2) doporučené / klíčové Nabídková cena nemovitosti v Kč (prodej) nebo měsíční nájemné v Kč (pronájem). Neobsahuje měnu ani oddělovače tisíců. Číslo, desetinná tečka, bez mezer a bez "Kč".
Např. 4250000 nebo 15000.00.
4250000.00
11 expenses_monthly decimal(12,2) volitelné Pravidelné měsíční náklady (zálohy na služby, energie apod.) v Kč. Číslo v Kč, desetinná tečka. Může být 0.00, pokud není uvedeno. 4800.00
12 property_type varchar(50) doporučené / klíčové Typ nemovitosti v interním číselníku GlovatoReal (např. byt, dům, pozemek, komerční prostor). Doporučeno používat hodnoty jako např.:
flat, house, land, commercial, garage
flat
13 house_type varchar(100) volitelné Upřesnění typu domu nebo objektu – např. řadový, samostatně stojící, vila, chalupa apod. Volný text, doporučeno držet se konzistentního slovníku. samostatně stojící rodinný dům
14 property_condition varchar(150) volitelné Stav nemovitosti – např. novostavba, po rekonstrukci, před rekonstrukcí, velmi dobrý stav apod. Volný text, např. po kompletní rekonstrukci, původní stav. novostavba
15 object_position varchar(150) volitelné Poloha objektu v rámci zástavby – např. samostatný, řadový, krajní řadový apod. Volný text – doporučeno např. samostatný, řadový, krajní řadový. řadový
16 object_location varchar(150) volitelné Upřesnění umístění objektu v rámci obce – např. centrum obce, klidná část obce, sídliště, okraj obce. Volný text – např. klidná část obce, centrum obce. klidná část obce
17 commercial_type varchar(150) volitelné Druh komerční nemovitosti – kancelář, obchodní prostor, sklad, výroba apod. Používá se pouze pro komerční typy nemovitostí. Volný text – např. kanceláře, obchodní prostor. kancelářské prostory
18 kamerovy_system tinyint(1) volitelné Informace, zda má objekt kamerový systém (bezpečnostní kamery). Jednoduchý boolean příznak. 0 = ne
1 = ano
1

Sekce 3 – Kontaktní osoba a agentura (sloupce 19–22)

# Sloupec (DB) Datový typ Povinné ve feedu Popis Formát / hodnoty Příklad
19 contact_name varchar(255) doporučené / klíčové Jméno kontaktní osoby (makléře nebo zástupce majitele), které se zobrazuje u inzerátu. Běžné jméno, bez speciálních omezení. Jan
20 contact_surname varchar(255) volitelné Příjmení kontaktní osoby. Může být ponecháno prázdné, pokud je jméno v poli contact_name uvedeno celé. Příjmení, volitelně. Novák
21 contact_phone varchar(20) doporučené / klíčové Telefonní číslo kontaktní osoby. Používá se pro zobrazení u inzerátu a pro přímý kontakt zájemce. Telefon ve formátu mezinárodním nebo národním, bez speciálních omezení, doporučeno: +420123456789. +420777123456
22 contact_email varchar(255) volitelné E-mailová adresa kontaktní osoby nebo kanceláře, na kterou chodí poptávky z GlovatoReal. Platná e-mailová adresa. jan.novak@realitni-kancelar.cz

Sekce 4 – Základní lokalita a hlavní obrázek (sloupce 23–24)

# Sloupec (DB) Datový typ Povinné ve feedu Popis Formát / hodnoty Příklad
23 location varchar(255) doporučené / klíčové Obecný textový popis lokality, typicky město + městská část nebo obec. Zobrazuje se v kartách nemovitostí. Volný text, např. Praha 4 – Braník, Brno - Žabovřesky. Praha 4 – Krč
24 image_url varchar(255) volitelné URL hlavního obrázku nemovitosti uloženého v systému GlovatoReal nebo externě. Může být použito jako fallback k tabulce property_images. Relativní cesta v rámci Glovato (např. uploads/images/...) nebo plná URL. uploads/images/byt_12345_main.jpg

Sekce 5 – Typ nemovitosti a typ transakce (sloupce 25–27)

# Sloupec (DB) Datový typ Povinné ve feedu Popis Formát / hodnoty Příklad
25 type varchar(50) doporučené Interní typ nemovitosti (hlavní kategorie), často používaný pro filtrování. Např.: byt, dům, pozemek, komercni, garaz. byt
26 transaction varchar(50) doporučené Textové označení transakce z původního zdroje (např. "pronájem", "prodej"). Může se lišit od transaction_type. Např.: prodej, pronájem. prodej
27 area int volitelné Obecná výměra nemovitosti (m²), pokud není zvlášť specifikováno. Celé číslo v m². 54

Sekce 6 – Plochy nemovitosti (sloupce 28–31)

# Sloupec Typ Povinné Popis Formát Příklad
28 floor_area_m2 decimal(10,2) volitelné Podlahová plocha bytu / objektu v m². Číslo s desetinnou tečkou. 53.60
29 built_up_area_m2 decimal(10,2) volitelné Zastavěná plocha domu / objektu. Číslo. 92.00
30 usable_area_m2 decimal(10,2) volitelné Užitná plocha objektu – hlavní využitelná plocha. Číslo. 140.00
31 total_area_m2 decimal(10,2) doporučené Celková plocha včetně pozemku, nebo celková výměra bytu. Číslo. 140.00

Sekce 7 – Počet místností a podlaží (sloupce 32–33)

# Sloupec Typ Povinné Popis Formát Příklad
32 rooms int volitelné Počet místností / pokojů. Celé číslo. 3
33 floor int volitelné Umístění bytu / kanceláře v rámci budovy. Celé číslo, může být 0 = přízemí. 2

Sekce 8 – Energetická náročnost a dostupnost (sloupce 34–35)

# Sloupec Typ Povinné Popis Formát Příklad
34 energy_class varchar(10) volitelné Energetická třída PENB. A–G nebo text. G
35 availability_date date volitelné Datum, kdy bude nemovitost k dispozici. YYYY-MM-DD 2026-01-12

Sekce 9 – Uživatelská vazba a status inzerátu (sloupce 36–40)

# Sloupec Typ Povinné Popis Formát Příklad
36 user_id int interní ID uživatele, který inzerát založil (majitel účtu). Číslo. 14
37 agent_id int volitelné ID makléře, který inzerát spravuje. Číslo. 77
38 buyer_id int volitelné ID uživatele – kupujícího (pokud existuje vazba). Číslo. NULL
39 is_visible tinyint(1) doporučené Viditelnost inzerátu na webu. 0 = skryto, 1 = viditelné. 1
40 is_recommended tinyint(1) volitelné Doporučený inzerát (tlačí se výše ve výsledcích). 0 = ne, 1 = ano 0

Sekce 10 – Časová metadata (sloupec 41)

# Sloupec Typ Povinné Popis Formát Příklad
41 created_at timestamp systémové Datum a čas vytvoření záznamu v GlovatoReal. Systém generuje automaticky. YYYY-MM-DD HH:MM:SS 2026-01-30 14:22:10

Sekce 11 – Vzdálenosti a občanská vybavenost (sloupce 42–45)

# Sloupec Typ Povinné Popis Formát Příklad
42 mhd_distance int volitelné Vzdálenost k nejbližší MHD v metrech. Celé číslo. 180
43 hospital_distance int volitelné Vzdálenost k nemocnici / poliklinice. Metry. 950
44 shopping_center_distance int volitelné Vzdálenost k nejbližšímu obchodnímu centru. Metry. 450
45 land_size int volitelné Velikost pozemku v m². Celé číslo. 650

Sekce 12 – Pozemek, orientace, topografie (sloupce 46–49)

# Sloupec Typ Povinné Popis Formát Příklad
46 soil_type varchar(100) volitelné Druh půdy – orná, trvalý travní porost, stavební pozemek… Text. stavební
47 building_orientation varchar(100) volitelné Světová orientace – např. východ, západ, jih, sever, případně kombinace. Text. jihovýchod
48 zoning varchar(100) volitelné Územní plán – např. obytná zástavba, rekreace, komerce. Text. obytná zóna
49 cellar_size int volitelné Velikost sklepa v m², pokud existuje. Číslo. 6

Sekce 13 – Garáž, povodňová rizika, oplocení (sloupce 50–52)

# Sloupec Typ Povinné Popis Formát Příklad
50 garage tinyint(1) volitelné Zda má nemovitost garáž. 0/1 1
51 flood_risk tinyint(1) volitelné Povodňové riziko (0 = ne, 1 = ano). 0/1 0
52 boundary_fencing varchar(100) volitelné Druh oplocení pozemku. Text. dřevěné

Sekce 14 – Přístup na pozemek, sítě, okolí (sloupce 53–55)

# Sloupec Typ Povinné Popis Formát Příklad
53 road_access varchar(100) volitelné Přístupová cesta – asfaltová, zpevněná, nezpevněná… Text. asfaltová
54 utilities varchar(255) volitelné Připojení na IS: voda, kanalizace, elektřina, plyn… Text / CSV hodnot. voda, elektřina, plyn
55 nearby_landmarks varchar(255) volitelné Důležitá místa v okolí. Text. park, škola, obchod

Sekce 15 – Povrch, konstrukce, sklepy, odpady (sloupce 56–60)

# Sloupec Typ Povinné Popis Formát Příklad
56 topography varchar(100) volitelné Povrch pozemku – rovinatý, svažitý… Text. rovinatý
57 construction_year int volitelné Rok výstavby. Čtyřmístné číslo. 2005
58 renovation_year int volitelné Rok rekonstrukce. Čtyřmístné číslo. 2018
59 building_material varchar(100) volitelné Materiál budovy – cihla, panel, dřevo… Text. cihla
60 basement enum('yes','no') volitelné Zda má nemovitost suterén / sklep. yes / no yes

Sekce 16 – Odpady, vybavení domácnosti (sloupce 61–64)

# Sloupec Typ Povinné Popis Formát Příklad
61 sewage enum('sewage','septic') volitelné Druh likvidace odpadních vod – kanalizace nebo septik. sewage / septic sewage
62 furnished enum('yes','no') volitelné Zda je nemovitost vybavená nábytkem. yes / no no
63 kitchen_only tinyint(1) volitelné Příznak, zda je v nabídce pouze kuchyň bez dalších místností. 0/1 0
64 washer tinyint(1) volitelné Přítomnost pračky v nemovitosti. 0/1 1

Sekce 17 – Domácí spotřebiče a mazlíčci (sloupce 65–69)

# Sloupec Typ Povinné Popis Formát Příklad
65 fridge tinyint(1) volitelné Přítomnost lednice. 0/1 1
66 pets_allowed enum('yes','no') volitelné Zda jsou v pronájmu povoleni domácí mazlíčci. yes / no yes
67 garden tinyint(1) volitelné Zda má nemovitost zahradu. 0/1 1
68 balcony tinyint(1) volitelné Balkon u bytu / domu. 0/1 1
69 terrace tinyint(1) volitelné Terasa. 0/1 0

Sekce 18 – Bazén, solární panely, wellness (sloupce 70–74)

# Sloupec Typ Povinné Popis Formát Příklad
70 swimming_pool tinyint(1) volitelné Zda má objekt bazén. 0/1 0
71 solar_panels tinyint(1) volitelné Solární panely na střeše nebo pozemku. 0/1 1
72 sauna tinyint(1) volitelné Zda má objekt saunu. 0/1 0
73 fitness_center tinyint(1) volitelné Fitness / posilovna v objektu nebo areálu. 0/1 1
74 waste_disposal tinyint(1) volitelné Likvidace odpadu – zda je dostupná. 0/1 1

Sekce 19 – Elektrické nabíjení, stav inzerátu, agentura a adresy (sloupce 75–80)

# Sloupec Typ Povinné Popis Formát Příklad
75 electric_charging tinyint(1) volitelné Nabíjecí stanice pro elektromobily. 0/1 0
76 ad_status enum('visible','hidden') doporučené Status inzerátu – zda je veřejný nebo skrytý. visible / hidden visible
77 address varchar(255) doporučené Plná adresa nemovitosti. Text. Branická 25, Praha 4
78 street varchar(255) volitelné Ulice nemovitosti. Text. Branická
79 postal_code varchar(20) doporučené PSČ. Text / číslo. 14700
80 contact_address varchar(255) volitelné Kontaktní adresa makléře nebo kanceláře. Text. Na Pankráci 58, Praha 4

Sekce 20 – Sekundární kontakty a informace o agentuře (sloupce 81–83)

# Sloupec Typ Povinné Popis Formát Příklad
81 secondary_contact varchar(255) volitelné Doplňující kontakt (např. asistent, druhý makléř). Text. Mgr. Lucie Benešová
82 agency_name varchar(255) volitelné Název realitní kanceláře. Text. Soccer Reality
83 agency_website varchar(255) volitelné Web kanceláře / makléře. URL. https://www.soccerreality.cz

Sekce 21 – Video, soubory a hlavní obrázek (sloupce 84–87)

# Sloupec Typ Povinné Popis Formát Příklad
84 video_url varchar(255) volitelné Externí video (YouTube, Vimeo…) URL. https://youtu.be/abc123
85 video_file_path varchar(255) volitelné Interně nahrané video ve file systému. Cesta. /uploads/video/byt123.mp4
86 image_file_path varchar(255) volitelné Cesta k hlavnímu obrázku (pokud není externí URL). Path. /uploads/images/byt123/1.jpg
87 main_image_url varchar(255) doporučené Hlavní obrázek v inzerátu. URL. /uploads/images/byt123/main.jpg

Sekce 22 – Časová metadata, TOP pozice, vystavení (sloupce 88–92)

# Sloupec Typ Povinné Popis Formát Příklad
88 updated_at timestamp systémové Datum poslední změny. Plní systém. YYYY-MM-DD HH:MM:SS 2026-01-30 15:44:00
89 is_top tinyint(1) volitelné Zda je inzerát mezi TOP (zvýrazněné). 0/1 1
90 condition varchar(255) volitelné Stav nemovitosti (detailnější popis). Text. po rekonstrukci
91 documents_url varchar(255) volitelné Externí dokumenty – půdorysy, energetické štítky… URL. /uploads/docs/floorplan.pdf
92 featured tinyint(1) volitelné Speciální zvýraznění (jiné než TOP). 0/1 0

Sekce 23 – Sportoviště, počty interakcí, školy & vzdálenosti (sloupce 93–100)

# Sloupec Typ Povinné Popis Formát Příklad
93 sports_facility varchar(255) volitelné Sportoviště v okolí. Text. tenisové kurty
94 saved_count int systémové Počet uložení do oblíbených. Číslo. 12
95 shared_count int systémové Počet sdílení. Číslo. 3
96 cinema varchar(255) volitelné Kino v okolí. Text. OC Chodov Cinema City
97 doctor_distance int volitelné Vzdálenost k lékaři. Metry. 300
98 train_distance int volitelné Vzdálenost k železniční stanici. Metry. 850
99 cellar enum('yes','no') volitelné Přítomnost sklepa. yes / no yes
100 primary_school varchar(255) volitelné Název nejbližší základní školy. Text. ZŠ U Krčského lesa

Sekce 24 – Školy, školky, obchody – názvy a vzdálenosti (sloupce 101–104)

# Sloupec Typ Povinné Popis Formát Příklad
101 primary_school_distance int volitelné Vzdálenost k nejbližší základní škole. Metry 450
102 kindergarten varchar(255) volitelné Název nejbližší mateřské školy. Text MŠ Sluníčko
103 kindergarten_distance int volitelné Vzdálenost ke školce. Metry 280
104 shopping_center varchar(255) volitelné Název nejbližšího obchodního centra. Text OC Nový Smíchov

Sekce 25 – Nemocnice, hřiště, autobusové spojení (sloupce 105–108)

# Sloupec Typ Povinné Popis Formát Příklad
105 hospital varchar(255) volitelné Název nemocnice nebo polikliniky. Text Thomayerova nemocnice
106 playground varchar(255) volitelné Dětské hřiště v blízkosti. Text Dětské hřiště U Lesa
107 bus_station varchar(255) volitelné Název nejbližší autobusové zastávky. Text Jílovská
108 bus_station_distance int volitelné Vzdálenost k autobusové zastávce. Metry 90

Sekce 26 – GPS souřadnice (sloupce 109–110)

# Sloupec Typ Povinné Popis Formát Příklad
109 latitude decimal(10,6) doporučené Zeměpisná šířka. Desetinný formát 50.032145
110 longitude decimal(10,6) doporučené Zeměpisná délka. Desetinný formát 14.413875

Sekce 27 – Stáří, energetika, parking a počet pater (sloupce 111–115)

# Sloupec Typ Povinné Popis Formát Příklad
111 property_age int volitelné Přibližné stáří objektu (v letech). Číslo 22
112 energy_efficiency varchar(50) volitelné Energetická náročnost – alternativní formát k energy_class. Text B
113 parking_type varchar(255) volitelné Druh parkovacího stání – kryté, venkovní, garáž… Text kryté stání
114 number_of_floors int volitelné Celkový počet pater objektu. Číslo 3
115 public_transport varchar(255) volitelné Dostupné typy MHD (bus, tramvaj, metro). CSV / text bus, tram

Sekce 28 – Statistiky, oznámení a agenturní informace (sloupce 116–120)

# Sloupec Typ Povinné Popis Formát Příklad
116 save_search tinyint(1) systémové Příznak – souvisí s uloženými hledáními uživatele. 0/1 0
117 notifications tinyint(1) systémové Zda má uživatel aktivní notifikace na tuto nemovitost. 0/1 1
118 image varchar(255) volitelné Alternativní obrázek (většinou historický systémový sloupec). URL /uploads/images/default.jpg
119 view_count int systémové Počet zobrazení inzerátu. Číslo 412
120 office_name varchar(255) volitelné Název pobočky realitní kanceláře. Text RK Praha – Pankrác

Sekce 29 – Agenturní informace a kontakty (sloupce 121–123)

# Sloupec Typ Povinné Popis Formát Příklad
121 agency_address varchar(255) volitelné Adresa realitní kanceláře. Text Budějovická 12, Praha 4
122 agency_phone varchar(20) volitelné Telefonní kontakt kanceláře. Text +420 777 123 456
123 agency_email varchar(255) volitelné E-mail kanceláře. E-mail info@rk.cz

Sekce 30 – Kdo inzeroval, dispozice, místnosti, GPS (sloupce 124–130)

# Sloupec Typ Povinné Popis Formát Příklad
124 listed_by varchar(255) doporučené Kdo inzerát vložil (makléř, kancelář, majitel). Text Ing. Jan Novák
125 bathrooms int volitelné Počet koupelen. Číslo 2
126 disposition varchar(50) volitelné Dispozice bytu / domu (např. 3+kk). Text 3+kk
127 city varchar(100) doporučené Město obce nemovitosti. Text Praha
128 kitchens int volitelné Počet kuchyní. Číslo 1
129 bedrooms int volitelné Počet ložnic. Číslo 3
130 lat decimal(10,6) volitelné Zeměpisná šířka (alternativní sloupec). GPS 50.032500

Sekce 31 – GPS souřadnice, slevy, datum slevy (sloupce 131–134)

# Sloupec Typ Povinné Popis Formát Příklad
131 lng decimal(10,6) volitelné Zeměpisná délka (alternativní sloupec). GPS 14.414200
132 house_number varchar(20) volitelné Číslo popisné / orientační. Text 25
133 price_cut decimal(10,2) volitelné Sleva oproti původní ceně. Částka 150000
134 price_cut_date date volitelné Datum, kdy byla sleva aplikována. YYYY-MM-DD 2026-01-15

Sekce 32 – Bezpečnostní prvky (sloupce 135–142)

# Sloupec Typ Povinné Popis Formát Příklad
135 security_camera tinyint(1) volitelné Kamerový systém. 0/1 1
136 electronic_security tinyint(1) volitelné Elektronický zabezpečovací systém. 0/1 0
137 gated_community tinyint(1) volitelné Uzavřený areál. 0/1 1
138 elevator tinyint(1) volitelné Výtah v budově. 0/1 1
139 air_conditioning tinyint(1) volitelné Klimatizace. 0/1 1
140 disabled_access tinyint(1) volitelné Bezbariérový přístup. 0/1 0
141 entry_gate tinyint(1) volitelné Vstupní brána / vrata. 0/1 1
142 internet tinyint(1) volitelné Připojení k internetu. 0/1 1

Sekce 33 – Slug, featured, zdroj dat, externí ID (sloupce 143–146)

# Sloupec Typ Povinné Popis Formát Příklad
143 slug varchar(255) povinné URL-friendly název inzerátu. text-hyphen-format prodej-bytu-3kk-praha-4
144 is_featured tinyint(1) volitelné Zvýrazněný inzerát (jiný typ než TOP). 0/1 1
145 source_id int volitelné ID zdroje (např. při importu). Číslo 3
146 external_id varchar(255) volitelné ID inzerátu z externího portálu. Text 987654

Kompletní specifikace KONEC

Sloupce 1–146 jsou nyní kompletně zdokumentované. Můžeme pokračovat vytvořením XML příkladu, XSD schématu nebo veřejné developerské stránky.