Domonaut od 20. srpna 2026 nabízí veřejné API realitních nabídek. Projekty, analytici a výzkumníci díky němu mohou získávat aktuální nabídky, sledovat jejich změny a pracovat s vybranými automaticky odvozenými údaji bez scrapování výsledků a detailů.
API je veřejné, nevyžaduje registraci ani API klíč. Klient se ale musí pravdivě identifikovat názvem projektu nebo firmy a funkčním kontaktním e-mailem. Tato identifikace slouží pro uplatnění limitů, řešení technických problémů a případnou komunikaci s provozovatelem.
Proč veřejné API místo scrapování
Klasický scraper musí pravidelně načítat stránky výsledků, otevírat jednotlivé detaily a z HTML znovu skládat informace, které už Domonaut uchovává ve strukturované podobě. To zbytečně zatěžuje obě strany a při každé změně vzhledu stránky může přestat fungovat.
API vrací data přímo jako JSON a nabízí stabilnější způsob pravidelné synchronizace. Klient nemusí hádat význam jednotlivých částí HTML ani opakovaně stahovat beze změny celý web. Může si vyžádat snapshot aktivních nabídek nebo pouze změny od poslední úspěšné kontroly.
Jeden endpoint a tři způsoby použití
Veřejné API používá endpoint GET https://domonaut.cz/api/offers.php. Podle parametrů jej lze využít třemi způsoby:
- Snapshot aktivních nabídek vrátí aktuální veřejnou nabídku Domonautu.
- Změny v časovém okně zahrnují vytvořené, upravené i archivované nabídky a změny vybraných AI návrhů.
- Jedna konkrétní nabídka umožní načíst aktivní nebo archivovaný záznam podle jeho ID.
Větší odpovědi se stránkují pomocí neprůhledného kurzoru a jedna dávka může obsahovat až 500 záznamů. Pro pravidelnou synchronizaci je vhodné nejprve načíst výchozí snapshot a poté navazovat změnovými okny. Přesný význam parametrů, aktuální limity a ukázkové požadavky jsou uvedené v dokumentaci veřejného API.
Aktuální i archivované realitní nabídky
Pro synchronizaci nestačí vědět jen to, které inzeráty jsou právě aktivní. Klient musí rozpoznat také změnu ceny, úpravu popisu nebo ukončení nabídky. Změnové čtení proto umí vracet i archivované záznamy.
Každá nabídka má stabilní interní ID a obsahuje odkaz na svůj veřejný detail. Uživatel dat tak může aktualizovat vlastní analytiku nebo monitoring a současně zachovat cestu k původnímu zdroji.
Jaká data realitní API obsahuje
Odpověď zahrnuje strukturované údaje o typu nabídky a nemovitosti, dispozici, ploše, stavu, vybavení, ceně, finančních podmínkách, lokalitě a životním cyklu inzerátu. Neznámé nebo pro daný typ nemovitosti nepoužitelné hodnoty se vracejí jako null.
Součástí mohou být také vybrané položky z offers_ai_suggestions. Jde například o automaticky získané návrhy finančních hodnot nebo vhodnosti nabídky pro určité skupiny zájemců. Tyto údaje vznikají extrakcí textu, nejsou potvrzené inzerentem a strukturovaná data nabídky před nimi mají přednost. Podrobněji způsob získávání popisuje článek o AI extrakci s validačními pravidly.
Soukromí a kontakty zůstávají chráněné
API neposkytuje telefonní čísla, e-mailové adresy ani jiné citlivé kontaktní údaje uživatelů. Rozpoznané kontakty se odstraňují také z textu nabídky.
Adresa a souřadnice respektují stejné nastavení soukromí jako při anonymním zobrazení detailu. Podle volby inzerenta tak může být skryté číslo domu, posunutá poloha nebo zcela skryté přesnější údaje o adrese.
Monitoring, analytika a výzkum s uvedením zdroje
Data lze používat pro monitoring, analytiku, výzkum nebo další povolené projekty. Veřejný výstup musí uvádět Domonaut jako zdroj a u konkrétní nabídky zachovat odkaz z API.
API není určené k vytvoření kopie celého portálu, nahrazení vlastní realitní inzerce ani k hromadnému archivování fotografií. Klienti musí respektovat aktuální provozní limity a podmínky popsané v dokumentaci.
Časté otázky
Je veřejné API Domonautu zdarma?
Ano. Veřejné API lze používat bez registrace a bez API klíče. Každý klient se ale musí pravdivě identifikovat názvem projektu nebo firmy a funkčním kontaktním e-mailem a musí dodržovat aktuální limity a podmínky použití.
Jaký endpoint API používá?
Nabídky jsou dostupné přes GET endpoint https://domonaut.cz/api/offers.php. Parametry určují, zda klient načítá snapshot aktivních nabídek, změny v časovém okně nebo jednu konkrétní nabídku.
Umí API vracet archivované nabídky?
Ano. Při čtení změn nebo jedné konkrétní nabídky lze pracovat také s archivovanými záznamy. Díky tomu může klient rozpoznat, že byla nabídka ukončena, a aktualizovat vlastní data.
Obsahuje API telefonní čísla nebo e-maily inzerentů?
Ne. API neposkytuje telefonní čísla, e-maily ani jiné citlivé kontaktní údaje. Adresa a poloha zároveň respektují nastavení soukromí inzerenta stejně jako při anonymním zobrazení nabídky.
Jsou AI údaje v API potvrzené inzerentem?
Ne. Vybrané AI návrhy vznikají automatickou extrakcí textu a nejsou potvrzené inzerentem. Strukturovaná pole nabídky mají před AI návrhy přednost a klient by měl původ automaticky odvozených údajů zachovat.