API

Kompletní popis ve formátu OpenAPI 3.1:https://api.tindreal.cz/openapi.json

Přehled endpointů

Metoda	Cesta	Popis
GET	`/v1/listings`	Výpis veřejných inzerátů (filtry, stránkování)
GET	`/v1/listings/{public_id}`	Detail inzerátu
GET	`/v1/codebooks`	Číselníky Sreality
POST / PATCH / DELETE	`/v1/listings`	Zápis inzerátů (X-API-Key, scope listings:write)
GET	`/v1/pro/rewards`	Odměny – jen ověření profesionálové (Bearer JWT)
POST / GET / DELETE	`/v1/webhooks`	Webhooky (X-API-Key, scope webhooks:manage)
GET	`/feed.json, /feed.xml`	JSON Feed a RSS posledních změn
POST	`https://import.tindreal.cz/RPC2`	XML-RPC import kompatibilní se Sreality (alias: /import/sreality/RPC2 na hostu API)

Ukázka

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

Zápis inzerátu

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, ...}'

Odměny

Veřejné endpointy odměny nikdy nevrací. Pro ověřené profesionály:

curl https://api.tindreal.cz/v1/pro/rewards -H "Authorization: Bearer <JWT uživatele>"

Import z realitního softwaru (kompatibilní se Sreality)

Software, který umí exportovat na Sreality, stačí nastavit na Tindreal: URL https://import.tindreal.cz/RPC2,client_id, heslo a klíč softwaru Tindreal. Přístupové údaje si vygenerujete vúčtu v sekci Import ze softwaru (je tam i testovací režim, kdy se inzeráty nezveřejní). Podrobnosti pro vývojáře:docs/pro-dodavatele-softwaru.md v repozitáři.

Strojově čitelný přehled: llms.txt. Další možnosti (MCP, import ze Sreality, příklady, limity):Pro boty a vývojáře.