Jak realitka nahraje celý katalog z CRM do Seeki
Naposledy revidováno: 2026-04-14
Realitka může nahrát celý katalog z CRM do Seeki přes ingest API. V dashboardu si vygeneruje klíč, pošle dávku nabídek v podporovaném formátu a každá nabídka se zpracuje a publikuje napříč evropskými trhy, které obsluhujeme, bez psaní vlastního kódu. Dashboard ukazuje průběh každé položky, vypisuje případné chyby a umožňuje opakovat selhané řádky bez nahrávání celé dávky znovu.
Tento článek je orientace, kterou bychom přáli každému provoznímu řediteli realitky, který se na Seeki dívá poprvé. Provede vás celým importem, od „máme tisíce nabídek v CRM" po „jsou živé na portálu ve všech jazycích, které obsluhujeme", a popíše, co očekávat v každém kroku.
5 kroků onboardingu
- Získejte API klíč. Přihlaste se do dashboardu realitky a v sekci API klíče vygenerujte klíč. Klíč je vázaný na vaši kancelář.
- Připravte data. Namapujte export z CRM do podporovaného formátu. Přijímáme Seeki-JSON (naše kanonické schéma), OpenImmo (evropský OASIS standard hojně používaný v DACH CRM) a Idealista XML-ML (běžný ve Španělsku a Portugalsku).
- Odešlete dávku. Pošlete soubor na ingest API. Velmi rozsáhlé katalogy se posílají po blocích.
- Sledujte přehled importů. Každá nabídka má vlastní řádek se živým stavem, důvodem případné chyby a tlačítkem pro opakování.
- Nabídky se publikují. Jakmile je nabídka zpracovaná, je živá ve všech podporovaných jazycích a vyhledatelná na zemských stránkách i v AI vyhledávači.
Většina práce je v kroku 2. Kroky 3 až 5 už běží na straně Seeki.
Co se s nabídkou děje po přijetí
Nabídka se na portálu neobjeví v okamžiku, kdy váš POST vrátí 200. Každá položka se asynchronně zvaliduje, doplní o odvozená data, oskóruje a publikuje. Většina nabídek je hotová během sekund. Pokud má nabídka opravitelný problém (chybí povinné pole, URL fotografie nereaguje, adresu nelze umístit na mapu), je v dashboardu označena jako selhaná s konkrétním důvodem a zbytek dávky pokračuje dál.
Není potřeba znát, co běží pod pokličkou. Co potřebujete vědět, je, že dashboard přesně ukazuje, kde každá nabídka je, a že oprava jednoho špatného záznamu nevyžaduje nahrávání celého feedu znovu.
Ruční zadávání, web import a API ingest
Tři způsoby publikace na Seeki, každý pro úplně jiný rozsah.
| Přístup | Náročnost nastavení | Čas na jednu nabídku | Pro koho | Škáluje na |
|---|---|---|---|---|
| Ruční zadávání | Žádná, stačí se přihlásit | 10 až 20 minut | Pár prémiových nabídek, kanceláře testující platformu | Desítky |
| Webový import (vložit / nahrát) | Nízká, jednorázové mapování | Sekundy na nabídku | Středně velké kanceláře bez vývojáře | Stovky až několik tisíc |
| API ingest | Dopoledne integrační práce | Sub-sekundu na nabídku | Kanceláře s CRM, častými aktualizacemi, vícezemským inventářem | Desítky tisíc |
Rozhodnutí je obvykle praktické: pokud váš CRM už exportuje OpenImmo nebo máte vývojáře, který umí vyrobit Seeki-JSON, je API cesta nejlevnější. Pokud jste butiková kancelář s pár desítkami prémiových nabídek, vystačíte si s ručním zadáváním.
Co dashboard importů ukazuje
V dashboardu tráví provozní pracovník realitky po prvním importu nejvíc času. Nahoře je souhrn každého importu (celkem položek, úspěšných, probíhajících, neúspěšných) a tabulka pod tím přesně říká, co se s každým záznamem děje. Vyfiltrujete si selhané, projedete sloupec důvodu, opravíte data v CRM a stisknete opakovat na dotčených řádcích. Není potřeba nahrávat celý feed znovu kvůli několika špatným záznamům.
Když se nabídka publikuje, řádek odkazuje přímo na veřejnou stránku, takže si ověříte, jak vypadá v cílovém jazyce.
Spravujte importy zde hned po vygenerování klíče.
Předplatné a přístup
API ingest je placená funkce pro realitky. Onboarding obsahuje krok s předplatným přes Stripe: vyberete tarif, vyplníte platební údaje nebo údaje k fakturaci a váš API klíč se aktivuje. Předplatné se fakturuje měsíčně s možností roční předplaty. Pokud předplatné vyprší, ingest se pozastaví. Stávající nabídky zůstávají publikované, ale nové importy se odmítají, dokud není fakturace v pořádku. Aktuální tarif, využití a případná upozornění na obnovení zobrazí dashboard na přehledové obrazovce.
Nad rámec předplatného se neúčtuje poplatek za jednotlivou nabídku. Propustnost se liší podle tarifu. Pokud potřebujete opravdu vysokou souběžnou propustnost, ozvěte se nám před objednávkou, ať vám pomůžeme vybrat správný plán.
Časté dotazy
Jaký formát dat je podporovaný?
Tři formáty. Seeki-JSON je naše kanonické schéma, plochý a dobře zdokumentovaný JSON pokrývající všechna pole nabídky a URL fotografií. OpenImmo (evropský OASIS standard hojně používaný v DACH CRM) se přijímá jako XML nebo jako zip s XML i soubory fotografií. Idealista XML-ML se přijímá od španělských a portugalských kanceláří, jejichž CRM už tímto dialektem mluví. Sekce API klíčů v dashboardu odkazuje na úplnou referenci schématu a interaktivní hřiště.
Jak se řeší duplicity?
Nabídky se identifikují kombinací vašeho ID realitky a externího ID nabídky, tedy identifikátoru, který už používá vaše CRM. Když pošlete nabídku se stejným externím ID znovu, Seeki ji považuje za aktualizaci, ne za novou. Díky tomu rutinní obnovy katalogu (denní, hodinové, nebo kdykoli vaše CRM emituje změnu) fungují bez jakékoli logiky deduplikace na vaší straně.
Mohu aktualizovat nabídky hromadně?
Ano. Ingest endpoint je stejný pro vytvoření i aktualizaci. Opětovné odeslání nabídky se změněnými poli aktualizuje živý záznam. Pokud chcete aktualizovat jen podmnožinu, pošlete jen ty nabídky. Seeki se nedotkne nabídek, které v dávce nejsou. Nabídku odstraníte tím, že ji v CRM označíte jako neaktivní a pošlete se stavem prodáno nebo staženo. Bude archivována z vyhledávání.
Co realitky mimo EU s evropským inventářem?
API nekontroluje, kde má vaše realitka sídlo. Kontroluje, jestli je země nabídky jedním z evropských trhů, které Seeki obsluhuje. Kancelář v Londýně nebo New Yorku, která drží španělský nebo český inventář, používá stejný ingest endpoint. Daňová a smluvní struktura na vaší straně je vaše odpovědnost. Smlouva se Seeki je za inzertní službu.
Jak rychle se nové nabídky objeví?
Nabídka je obvykle hotová během sekund. Celkový čas od vašeho POST po veřejně vyhledatelnou nabídku závisí na velikosti dávky a aktuálním zatížení, ale malé dávky se obvykle publikují s časem pod minutu na nabídku. Překlady do dalších jazyků se generují při prvním zobrazení. Nabídka je tedy plně vyhledatelná ve zdrojovém jazyce ihned a v přeložené podobě se objeví, jakmile ji někdo poprvé otevře v jiné lokalizaci.
Co když nabídka neprojde validací?
Je v dashboardu označena jako selhaná s konkrétním důvodem: chybějící povinné pole, nedostupná URL fotografie, cena pod hranicí věrohodnosti apod. Zbytek dávky pokračuje. Opravte data v CRM, znovu exportujte a buď pošlete celou dávku, nebo zopakujte selhané řádky z dashboardu. Za opakování není žádný postih a deduplikace podle externího ID brání náhodným duplicitám.
Další kroky
Pokud je vaše kancelář připravená, cesta je krátká: vygenerujte klíč, pošlete malou testovací dávku z exportu CRM, sledujte ji v dashboardu a pak zapněte plný feed. Záměrně držíme nejmenší možnou vzdálenost mezi „mám CSV" a „nabídky jsou živé po celé Evropě". Provozní složitost má absorbovat platforma, ne ji vracet zpátky vám.
Až budete připraveni, stránka onboardingu vás provede generováním klíče, platbou i prvním importem v jednom toku.