API
Complete description in OpenAPI 3.1 format:https://api.tindreal.cz/openapi.json
Endpoint overview
| Method | Path | Description |
|---|---|---|
| GET | /v1/listings | List public listings (filters, pagination) |
| GET | /v1/listings/{public_id} | Listing detail |
| GET | /v1/codebooks | Sreality codebooks |
| POST / PATCH / DELETE | /v1/listings | Write listings (X-API-Key, scope listings:write) |
| GET | /v1/pro/rewards | Rewards – verified professionals only (Bearer JWT) |
| POST / GET / DELETE | /v1/webhooks | Webhooks (X-API-Key, scope webhooks:manage) |
| GET | /feed.json, /feed.xml | JSON Feed and RSS of the latest changes |
| POST | https://import.tindreal.cz/RPC2 | Sreality-compatible XML-RPC import (alias: /import/sreality/RPC2 on the API host) |
Example
curl "https://api.tindreal.cz/v1/listings?advert_function=1&advert_type=1&city=Praha&price_max=6000000&limit=10"Writing a listing
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, ...}'Rewards
Public endpoints never return rewards. For verified professionals:
curl https://api.tindreal.cz/v1/pro/rewards -H "Authorization: Bearer <user JWT>"Import from real estate software (Sreality-compatible)
Software that can export to Sreality only needs to be pointed at Tindreal: URL https://import.tindreal.cz/RPC2,client_id, password and software key Tindreal. You generate the credentials inyour account under Import from software (there is also a test mode in which listings are not published). Developer details:docs/pro-dodavatele-softwaru.md in the repository.
Machine-readable overview: llms.txt. More options (MCP, Sreality import, examples, limits):For bots and developers.