API & integrace / Inzeráty & vyhledávání
Inzeráty & vyhledávání
Hledání, detail, alerty, push notifikace
6 endpointů v této kategorii.
GET /api/listingsVyhledat inzeráty. Query: q, city (multi: ?city=X&city=Y nebo ?cities=X,Y CSV), offerType (sale|rent), category (apartment|house|commercial), layout, priceMin/Max, areaMin/Max, page, sort. Cache headers + Netlify-Vary per query param.
curl https://jistybyt.cz/api/listings?cities=Praha,Brno&offerType=rent&layout=2%2Bkk&priceMax=20000
GET /api/listings/feed.xmlCustom Jistybyt XML feed inzerátů (<jistybyt-feed><property>...). NEní native ARK/Realman/Realtor XML 2.x — partner musí napsat adapter (~50 LOC), nebo počkat na ARK/Realman native adapter Q3 2026. Cache 30 min.
curl https://jistybyt.cz/api/listings/feed.xml
GET /api/alerts/streamServer-Sent Events stream s alerty (match / price / expired). Heartbeat 25 s.
const ev = new EventSource("/api/alerts/stream"); ev.addEventListener("match", e => …);POST /api/push/subscribeWeb Push subscription. Body: PushSubscription JSON. Vrátí VAPID public key.
navigator.serviceWorker.ready.then(reg => reg.pushManager.subscribe({…}))GET /api/searchFull-text search napříč inzeráty + glossary + blog + cities. Q parameter, max 20 hits, mixed result types.
curl "https://jistybyt.cz/api/search?q=PENB"
POST /api/messagesInquiry/kontaktní formulář. Body: { kind, listingId, name, email, phone?, message }. kind: "private-inquiry" | "public-question" | "viewing-request".
curl -XPOST https://jistybyt.cz/api/messages -H "Content-Type: application/json" -d '{"kind":"private-inquiry","listingId":"pq19b3","name":"Petr","email":"p@e.cz","message":"Mám zájem o prohlídku."}'
→ Plný katalog všech 144 endpointů
→ API overview (rate limity, widgety, MCP config)