Search homes for sale or rent
search_propertiesUse this when the user wants to find a home for sale or rent in the Czech Republic — a flat, house, cottage or building plot — by layout (2+kk, 3+1…), town, district or city part, price, floor area or features. Covers listings agencies and sellers published on LivinIsto directly and public listings from Czech property portals. Pass the criteria as ONE short phrase in Czech (Slovak also works), with numbers as the user said them. Examples that are fully understood: "byt 2+kk Praha do 6 milionů", "pronájem 1+1 Brno do 15000", "rodinný dům Plzeň do 8 milionů", "pozemek Kolín". Leave out filler words (hledám, prosím, pěkný); words that are not a recognised filter are either matched in the listing text (matchedInText) or not applied (notUnderstood). At most 6 such unrecognised words are matched in the text; any beyond that are returned in notUnderstood. Returns up to 10 homes, what was understood, which criteria were relaxed when nothing matched exactly, which words were not applied, and a link to all results. Limits: only homes currently listed on LivinIsto (Czech Republic, prices in CZK, rents monthly); no commercial property, garages, holiday stays or property abroad; the offer changes daily, so a home may already be gone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Concrete criteria in Czech, e.g. "byt 3+kk Brno do 7 milionů" or "pronájem 2+1 Ostrava". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| query | Yes | ||
| relaxed | Yes | Criteria dropped or widened because nothing matched exactly, in Czech: the relaxation step, then each understood filter the results may NOT satisfy. | |
| summary | Yes | LivinIsto's own Czech sentence about the results (what was found, relaxed and how it is sorted). | |
| properties | Yes | Up to 10 listings in LivinIsto's order (listings published directly on LivinIsto first, then best value or closest to the budget). | |
| understood | Yes | Filters LivinIsto read from the phrase AND applied to these results, in Czech (e.g. byt, 2+kk, Praha, do 6 000 000 Kč). A filter that had to be dropped is in relaxed instead, never here. | |
| transaction | Yes | Sale unless the phrase asked for rent (or the budget can only be a monthly rent — then summary says so). | |
| totalMatches | Yes | How many listings in the offer match (after relaxing, if any). | |
| allResultsUrl | Yes | All matching listings on www.livinisto.cz. | |
| matchedInText | Yes | Words that are not a filter LivinIsto understands; results were narrowed to listings whose text contains them. Say so — the text match is not a verified feature. | |
| notUnderstood | Yes | Words from the query that were NOT applied at all. Empty together with empty relaxed and matchedInText = the results match everything in the query. |