Search Flatio listings
flatio_search_listingsUse this when someone wants to rent a furnished flat, house or room for a month or longer and names a city or country, with or without dates, budget, size or pets. It returns up to 10 listings per page with the monthly price and a link to the listing on flatio.com, where the guest books. It takes dates, a budget, a size and pets as filters. Not for nightly or holiday stays, and not for buying property. Give the guest each listing's url exactly as returned, with all its query parameters.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"location": "<location>"
},
"name": "flatio_search_listings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pets | No | true when a pet moves in. | |
| sort | No | Order of the listings, the same as on flatio.com. | recommended |
| limit | No | Listings per page, 1 to 10. | |
| cursor | No | next_cursor of the previous page, sent with the same filters. | |
| guests | No | People moving in, e.g. 2. | |
| months | No | Stay length in months when there are no dates, e.g. 6. Not together with move_in. | |
| move_in | No | Move-in date as YYYY-MM-DD, e.g. "2027-02-01". Leave out when the dates are not known. | |
| currency | No | Currency of max_monthly_price and of every price in the result, e.g. "EUR". Defaults to the currency of the response language's Flatio site. | |
| language | No | Language of titles, texts and links, e.g. "en", "cs", "de", "es", "pt". Defaults to the language the client reports, else English. | |
| location | Yes | City or country name in any language, e.g. "Lisbon", "Praha", "Portugal". A neighbourhood or an address is not accepted. | |
| move_out | No | Move-out date as YYYY-MM-DD, after move_in, e.g. "2027-08-01". Needs move_in. | |
| bedrooms_min | No | Fewest rooms with a bed, e.g. 2, the same as the bedrooms filter on flatio.com. A living room with a sofa bed counts, so a listing can show fewer bedrooms. | |
| property_type | No | apartment is a whole flat, house a whole house, room a private room in a shared flat. | |
| max_monthly_price | No | Highest monthly rent in the given currency, e.g. 1500. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | All listings matching the filters, of which at most 100 can be paged. | |
| message | Yes | ||
| listings | Yes | ||
| next_cursor | Yes |