{"openapi":"3.1.0","info":{"title":"GROO reality — veřejné API","version":"1.0.0","description":"Nabídka nemovitostí realitní kanceláře GROO reality (Lenka Prajková, DiS.).\n\nČtení je otevřené a bez klíče; rozsah dat je stejný jako na webu. Limit je 60 požadavků za minutu na IP.\n\nKontaktní formulář API záměrně nenabízí — kontakt navazuje člověk.","contact":{"name":"GROO reality","email":"prajkova@groo.cz","url":"https://www.groo.cz/"},"license":{"name":"CC BY 4.0","identifier":"CC-BY-4.0"},"termsOfService":"https://www.groo.cz/pravni-informace"},"servers":[{"url":"https://www.groo.cz/api/v1","description":"Ostrý provoz"}],"externalDocs":{"url":"https://www.groo.cz/pro-ai","description":"Stránka o strojových rozhraních — pro lidi i pro agenty"},"paths":{"/nabidky":{"get":{"operationId":"vypisNabidek","summary":"Výpis nabídek","description":"Filtr přijímá tytéž parametry jako výpis na webu. Povolené hodnoty vrací /ciselniky.","parameters":[{"name":"typ","in":"query","required":false,"schema":{"type":"string","examples":["prodej"]},"description":"prodej | pronajem"},{"name":"kategorie","in":"query","required":false,"schema":{"type":"string","examples":["byt"]},"description":"byt | dum | pozemek | komercni | ostatni"},{"name":"dispozice","in":"query","required":false,"schema":{"type":"string","examples":["2+kk,3+1"]},"description":"Štítky oddělené čárkou; kategorii z nich odvodí"},{"name":"obec","in":"query","required":false,"schema":{"type":"string","examples":["Praha"]},"description":"Obec ze seznamu v /ciselniky"},{"name":"cena_do","in":"query","required":false,"schema":{"type":"string","examples":["9000000"]},"description":"Horní hranice ceny v Kč. Neodlišuje prodej od pronájmu — kombinujte s typ."},{"name":"vymera_od","in":"query","required":false,"schema":{"type":"string","examples":["60"]},"description":"Dolní hranice výměry v m²"},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Fulltext přes obec, ulici, dispozici i číslo nabídky"},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"minimum":1,"maximum":200}},{"name":"offset","in":"query","schema":{"type":"integer","default":0,"minimum":0}}],"responses":{"200":{"description":"Stránka výsledků","content":{"application/json":{"schema":{"type":"object","properties":{"celkem":{"type":"integer","description":"Počet všech odpovídajících"},"cena_na_vyzadani":{"type":"integer","description":"Kolik z nich má cenu na vyžádání. Takové nabídky projdou jakýmkoli cena_do, takže o ně je celkem nadhodnocené."},"limit":{"type":"integer"},"offset":{"type":"integer"},"dalsi":{"type":["string","null"],"format":"uri","description":"Odkaz na další stránku, nebo null na konci."},"filtr":{"type":"object","description":"Jak byl dotaz pochopen."},"polozky":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","examples":["groo1516"]},"url":{"type":"string","format":"uri"},"nazev":{"type":"string"},"typ":{"type":["string","null"],"enum":["prodej","pronájem",null]},"kategorie":{"type":["string","null"],"enum":["byt","dum","pozemek","komercni","ostatni",null]},"vymera_m2":{"type":["number","null"]},"cena":{"type":"object","properties":{"castka":{"type":["number","null"],"description":"null = cena na vyžádání"},"mena":{"type":["string","null"],"examples":["CZK"]},"jednotka":{"type":["string","null"],"examples":["za měsíc"]},"skryta":{"type":"boolean"}}},"adresa":{"type":"object","properties":{"obec":{"type":["string","null"]},"cast_obce":{"type":["string","null"]},"ulice":{"type":["string","null"],"description":"Jen u nabídek, kde ulici ukazuje i stránka."},"psc":{"type":["string","null"]},"gps":{"type":["object","null"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"}}}}},"stav":{"type":"string","examples":["v nabídce","prodáno"]},"nahled":{"type":["string","null"],"format":"uri"},"perex":{"type":["string","null"]}}}}}}}}},"400":{"description":"Neplatný parametr"},"429":{"description":"Překročený limit požadavků"}}}},"/nabidky/{id}":{"get":{"operationId":"detailNabidky","summary":"Detail nabídky","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","examples":["groo1516"]},"description":"Číslo nabídky jako v URL webu; projde i holé číslo."}],"responses":{"200":{"description":"Nabídka i s popisem, parametry, fotkami a makléřem","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"id":{"type":"string","examples":["groo1516"]},"url":{"type":"string","format":"uri"},"nazev":{"type":"string"},"typ":{"type":["string","null"],"enum":["prodej","pronájem",null]},"kategorie":{"type":["string","null"],"enum":["byt","dum","pozemek","komercni","ostatni",null]},"vymera_m2":{"type":["number","null"]},"cena":{"type":"object","properties":{"castka":{"type":["number","null"],"description":"null = cena na vyžádání"},"mena":{"type":["string","null"],"examples":["CZK"]},"jednotka":{"type":["string","null"],"examples":["za měsíc"]},"skryta":{"type":"boolean"}}},"adresa":{"type":"object","properties":{"obec":{"type":["string","null"]},"cast_obce":{"type":["string","null"]},"ulice":{"type":["string","null"],"description":"Jen u nabídek, kde ulici ukazuje i stránka."},"psc":{"type":["string","null"]},"gps":{"type":["object","null"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"}}}}},"stav":{"type":"string","examples":["v nabídce","prodáno"]},"nahled":{"type":["string","null"],"format":"uri"},"perex":{"type":["string","null"]}}},{"type":"object","properties":{"popis":{"type":["string","null"]},"dispozice":{"type":["string","null"],"examples":["3+kk"]},"parametry":{"type":"array","items":{"type":"object","properties":{"nazev":{"type":"string"},"hodnota":{"type":"string"},"jednotka":{"type":["string","null"]}}}},"fotky":{"type":"array","items":{"type":"string","format":"uri"}},"zverejneno":{"type":["string","null"],"format":"date"},"makler":{"type":["object","null"],"properties":{"jmeno":{"type":"string"},"telefon":{"type":"string"},"email":{"type":"string"}}}}}]}}}},"404":{"description":"Nabídka neexistuje nebo není veřejná"},"429":{"description":"Překročený limit požadavků"}}}},"/ciselniky":{"get":{"operationId":"ciselniky","summary":"Povolené hodnoty filtru","description":"Typy, kategorie s dispozicemi a obce, ve kterých nabídky jsou.","responses":{"200":{"description":"Číselníky"},"429":{"description":"Překročený limit požadavků"}}}},"/poptavky":{"get":{"operationId":"poptavky","summary":"Co kancelář shání","description":"Nemovitosti, které kancelář aktivně poptává pro klienty — opačný směr než výpis nabídek.","responses":{"200":{"description":"Seznam poptávek"},"429":{"description":"Překročený limit požadavků"}}}},"/projekty":{"get":{"operationId":"projekty","summary":"Developerské projekty","responses":{"200":{"description":"Seznam projektů"},"429":{"description":"Překročený limit požadavků"}}}},"/aktuality":{"get":{"operationId":"aktuality","summary":"Novinky kanceláře","responses":{"200":{"description":"Seznam článků"},"429":{"description":"Překročený limit požadavků"}}}},"/reference":{"get":{"operationId":"reference","summary":"Reference klientů","responses":{"200":{"description":"Seznam referencí"},"429":{"description":"Překročený limit požadavků"}}}},"/kontakt":{"get":{"operationId":"kontakt","summary":"Kontakt na kancelář","responses":{"200":{"description":"Kontaktní údaje"},"429":{"description":"Překročený limit požadavků"}}}}}}