Pro partnery

Rozhraní API a integrace

RealityGuide umožňuje realitním sítím, finančně-poradenským společnostem i vývojářům propojit jejich interní systémy se stavem našich zakázek a daty z katastru.

1. Autentizace

Všechny API požadavky musí obsahovat hlavičku Authorization s vaším API tokenem vygenerovaným v nastavení vašeho profesionálního účtu.

GET /api/v1/properties HTTP/1.1
Host: api.realityguide.cz
Authorization: Bearer rg_live_prod_549320849208a0d9f
Accept: application/json

2. Získání seznamu nemovitostí

Tento koncový bod vrací seznam vašich aktivních zakázek a inzerovaných nemovitostí včetně stavu z katastru nemovitostí.

Příklad cURL požadavku:
curl -X GET "https://api.realityguide.cz/v1/properties" \
  -H "Authorization: Bearer rg_live_prod_549320849208a0d9f"
Příklad odpovědi (JSON):
{
  "success": true,
  "data": [
    {
      "id": "prop_908f430f89d",
      "title": "Byt 2+kk, 56m² - Praha 5",
      "price": 6200000,
      "status": "active",
      "cuzk_verified": true,
      "cuzk_last_check": "2026-06-06T12:00:00Z"
    }
  ]
}

Máte zájem o plný přístup do API?

Plná dokumentace, specifikace OpenAPI/Swagger a Webhook callback rozhraní jsou k dispozici pro schválené makléřské a poradenské sítě. Pro aktivaci vývojářského účtu kontaktujte svého administrátora nebo napište na info@realityguide.cz.