# Tindreal API

> Tindreal (https://tindreal.cz) je český realitní portál. Toto API poskytuje veřejné inzeráty, číselníky
> kompatibilní se Sreality, zápis inzerátů přes API klíč, webhooky a import ve formátu Sreality (XML-RPC).

## Dokumentace
- OpenAPI 3.1: https://api.tindreal.cz/openapi.json
- Číselníky: https://api.tindreal.cz/v1/codebooks
- JSON Feed: https://api.tindreal.cz/feed.json, RSS: https://api.tindreal.cz/feed.xml

## Pro AI agenty: MCP server
Vzdálený MCP server (Model Context Protocol, Streamable HTTP): https://mcp.tindreal.cz/mcp – hledání inzerátů (včetně okolí), detail, číselníky,
uložená hledání, zadávání inzerátů a fotek. Veřejné čtení bez přihlášení; zápis přes OAuth 2.1 nebo API klíč. Popis: https://mcp.tindreal.cz/llms.txt

## Veřejné čtení (bez autorizace)
- GET https://api.tindreal.cz/v1/listings?advert_function=1&advert_type=1&city=Praha&price_max=6000000&page=1&limit=20
  (pro velké výpisy použijte keyset stránkování: `cursor=<next_cursor z předchozí odpovědi>`, filtr `country=CZ|SK|…`; ulice a přesné souřadnice se u znepřesněné polohy nevracejí)
- GET https://api.tindreal.cz/v1/listings/{public_id}

## Zápis (hlavička X-API-Key: tr_live_…)
- POST https://api.tindreal.cz/v1/listings, PATCH/DELETE https://api.tindreal.cz/v1/listings/{public_id}
- POST/GET https://api.tindreal.cz/v1/webhooks, DELETE https://api.tindreal.cz/v1/webhooks/{id}
- Scopy klíče: listings:read, listings:write, webhooks:manage, searches:manage (uložená hledání v MCP)

## Odměny za přivedení kupce
Veřejné odpovědi odměny NIKDY neobsahují. Ověření profesionálové je čtou na
https://api.tindreal.cz/v1/pro/rewards s hlavičkou Authorization: Bearer <Supabase JWT>; přístup vynucuje databáze (RLS).

## Import ze Sreality
XML-RPC kompatibilní se Sreality: POST https://import.tindreal.cz/RPC2 (alias https://api.tindreal.cz/import/sreality/RPC2; software_key "Tindreal"; client_id a heslo vydává účet na https://tindreal.cz/ucet/import). Tindreal na Sreality neexportuje.