Input schema (JSON)
{
"type": "object",
"required": [
"city"
],
"properties": {
"to": {
"type": "string",
"format": "date",
"example": "2027-01-31",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Move-out date, YYYY-MM-DD. Returns places available until at least this day or open-ended."
},
"max": {
"type": "integer",
"example": 4000,
"maximum": 1000000,
"description": "Maximum monthly rent in the currency of lang, so max=4000&lang=pl means 4000 zł and max=900&lang=en means €900.",
"exclusiveMinimum": 0
},
"city": {
"enum": [
"warszawa",
"krakow"
],
"type": "string",
"example": "warszawa",
"description": "City slug. warszawa is Warsaw, krakow is Kraków."
},
"from": {
"type": "string",
"format": "date",
"example": "2026-11-01",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Move-in date, YYYY-MM-DD. Returns places available on or before this day."
},
"lang": {
"enum": [
"pl",
"en"
],
"type": "string",
"default": "en",
"description": "Response language and currency. pl returns prices in zł (PLN), en returns prices in € (EUR). Use the currency the user's budget is in."
},
"pets": {
"type": "boolean",
"description": "Only places that allow pets."
},
"sort": {
"enum": [
"best",
"cheapest",
"newest"
],
"type": "string",
"default": "best",
"description": "Listings available by the move-in day (from, or today without from) come first, as on the website. Within each group, best fit first (value for money, area, transit time to the centre, listing quality and freshness, with at most two in a row from one building), cheapest monthly rent first, or newest first."
},
"type": {
"type": "array",
"items": {
"enum": [
"room",
"studio",
"flat",
"whole"
],
"type": "string"
},
"description": "Place types, comma separated in a URL. room is a private or shared room, studio is a one-room whole place, flat is any other whole place, whole is studio and flat together. Each result carries type room, studio or flat."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Results per page."
},
"rooms": {
"type": "integer",
"example": 1,
"maximum": 10,
"minimum": 1,
"description": "Minimum number of rooms in a whole place, as the ad counts them. Implies a whole place. Ads count differently. Some count bedrooms, others count every room the Polish way, where a studio is 1 room and a one-bedroom flat is 2. For a one-bedroom, use rooms=1 and say which results have type studio, or rooms=2 to rule studios out."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 5000,
"minimum": 0,
"description": "Results to skip, for paging."
},
"district": {
"type": "string",
"example": "mokotow",
"maxLength": 40,
"minLength": 2,
"description": "District name. Accents, case and hyphens are optional, so mokotow, Mokotów and praga poludnie all work. GET /api/v1/cities lists every district."
},
"furnished": {
"type": "boolean",
"description": "Only furnished places."
}
},
"additionalProperties": false
}