Tindreal API

Pro boty a vývojáře

Tindreal je od začátku stavěný i pro stroje. Každá nabídka má stabilní adresu, čistá data a otevřené rozhraní.

REST API a OpenAPI běží

JSON přes HTTPS, stránkování, filtry a řazení. Číselníky jsou kompatibilní se Sreality. Souřadnice jsou záměrně znepřesněné a odměny se ve veřejném API nikdy nevrací.

llms.txt běží

Stručný popis webu a API pro jazykové modely a crawlery. Každá stránka také odkazuje na strojově čitelnou verzi (<link rel="alternate" type="application/json">) a obsahuje data ve formátu schema.org (JSON-LD).

https://www.tindreal.cz/llms.txt
https://api.tindreal.cz/llms.txt (popis API)

MCP server pro AI asistenty ve vývoji

Model Context Protocol umožní asistentům (Claude, ChatGPT, Cursor a další) hledat nabídky a číst jejich detail přímo přes nástroje. Server bude dostupný jako Streamable HTTP endpoint:

https://mcp.tindreal.cz/

Zatím ve vývoji. Adresa ještě neodpovídá a konfigurace níže je plánovaná – začne fungovat po spuštění serveru. Do té doby používejte REST API. Plánované nástroje: hledání nabídek, detail nabídky, číselníky.

Claude Code

příkazová řádka

claude mcp add --transport http tindreal https://mcp.tindreal.cz/

Claude (Desktop / web)

Nastavení → Konektory → Přidat vlastní konektor

Název: Tindreal
URL vzdáleného MCP serveru: https://mcp.tindreal.cz/

ChatGPT

Nastavení → Konektory (režim pro vývojáře) → Vytvořit

Název: Tindreal
URL MCP serveru: https://mcp.tindreal.cz/
Autentizace: žádná (veřejná data)

Cursor

.cursor/mcp.json (nebo ~/.cursor/mcp.json)

{
  "mcpServers": {
    "tindreal": {
      "url": "https://mcp.tindreal.cz/"
    }
  }
}

Import kompatibilní se Sreality běží

Dodavatelé realitního softwaru mohou používat stejné XML-RPC rozhraní, na jaké jsou zvyklí: POST https://api.tindreal.cz/import/sreality/RPC2. Přihlášení, metody a číselníky odpovídají dokumentaci Sreality; podrobnosti jsou v repozitáři v docs/sreality-import.md. Klíč vytvoříte po přihlášení v sekci Účet → API klíče.

Příklady volání

curl

curl "https://api.tindreal.cz/v1/listings?advert_function=1&advert_type=1&city=Praha&price_max=8000000&limit=10"
curl "https://api.tindreal.cz/v1/listings/100001"

JavaScript

const res = await fetch('https://api.tindreal.cz/v1/listings?advert_function=1&city=Brno&limit=5', {
  headers: { Accept: 'application/json' },
});
const { items, total } = await res.json();

Zápis (klíč s oprávněním listings:write)

curl -X POST https://api.tindreal.cz/v1/listings \
  -H "X-API-Key: tr_live_..." -H "Content-Type: application/json" \
  -d '{"advert_function":1,"advert_type":1,"advert_subtype":4, ...}'

Rate limity

Limity platí na okno 60 sekund zvlášť pro IP adresu a pro API klíč. Odpověď nese hlavičky RateLimit-Limit, RateLimit-Policy a při překročení stav 429 s Retry-After. Konkrétní hodnoty může provozovatel změnit.

Třída	Endpointy	Na IP / min	Na klíč / min
Veřejné čtení	`GET /v1/listings, /v1/codebooks, feedy`	120	600
Zápis	`POST/PATCH/DELETE /v1/listings, webhooky`	120	60
Import (XML-RPC)	`POST /import/sreality/RPC2`	60	60
Účet (přihlášený)	`GET /v1/me/…, /v1/pro/…`	120	120

Podmínky používání

Veřejná data jsou určena k hledání a zobrazování nabídek s uvedením zdroje (Tindreal) a odkazem na detail.
Neobcházejte rate limity, neukládejte sdílené klíče do veřejných repozitářů, nepokoušejte se o zpřesnění znepřesněné polohy.
Telefony ani e-maily prodávajících veřejně nezveřejňujeme; kontakt probíhá přes formulář.
Odměny za přivedení kupce jsou neveřejné: Tindreal si z nich nic nebere a není stranou dohody (Pro profesionály).
Zkušební provoz (MVP): rozhraní se může měnit, změny oznamujeme v OpenAPI a ve feedu.