# Listings for sale on the Maszbox.pl platform

Listings are shown only once a category (listingCategory) or a city (listingCity) is chosen. Add one to the parameters, e.g. https://maszbox.pl/en/szukaj.md?listingCity=warszawa&listingCategory=apartment, or open a category and city address, e.g. https://maszbox.pl/en/mieszkania/warszawa.md.

## Listings for sale

Select a category to see spaces available for sale. You can also use the search to narrow offers down to a specific location.

- [Apartments](https://maszbox.pl/en/mieszkania/na-sprzedaz.md)
- [Houses](https://maszbox.pl/en/domy/na-sprzedaz.md)
- [Containers](https://maszbox.pl/en/kontenery/na-sprzedaz.md)
- [Garages](https://maszbox.pl/en/garaze/na-sprzedaz.md)
- [Parking spaces](https://maszbox.pl/en/miejsca-postojowe/na-sprzedaz.md)
- [Plots](https://maszbox.pl/en/dzialki/na-sprzedaz.md)
- [Storage units](https://maszbox.pl/en/komorki-lokatorskie/na-sprzedaz.md)
- [Units](https://maszbox.pl/en/lokale/na-sprzedaz.md)
- [Warehouses](https://maszbox.pl/en/magazyny/na-sprzedaz.md)
- [Wedding halls](https://maszbox.pl/en/sala-weselna/na-sprzedaz.md)

## Questions and Answers

### How does the space search work?

Enter a city or district and pick a category of space. You can narrow the results with a radius around the chosen location and with extra filters - offer type, condition, type of access or contract.

### Which categories of space are available?

You can choose from apartments, houses, rooms, attics, basements, storage units, garages and parking spaces, warehouses, containers, commercial units, wedding halls and plots - both for rent and for sale.

### Can I search within a specific district?

Yes. After choosing a city you can point to a specific district, or instead set a search radius around the city, but not both at once.

### Do I need an account to browse listings?

No. Browsing listings and contacting an advertiser require no account. You only need one once you want to add a listing of your own.

### Can I browse offers on a map?

Yes. Above the results there is a map with every offer matching your current filters. Markers close together merge into groups, and clicking a group shows the listings from that spot so you can jump straight to one of them. On a phone the map opens with the “Show on map” button.

## How to search listings

You can search listings without JavaScript: https://maszbox.pl/en/szukaj.md returns results as Markdown. For an agent the simplest way is to pass every filter as a query parameter to that address. Every results address also works with the .md suffix, and a regular page address returns Markdown when the request sends the Accept: text/markdown header.

Result urls are built from the segments category/type/city/district, e.g. /en/mieszkania/na-sprzedaz/warszawa/bemowo. The type is na-wynajem (rent) or na-sprzedaz (sale), and the category slugs match the listingCategory values: mieszkania = apartment, domy = house, strychy = attic, piwnice = basement, garaze = garage, miejsca-postojowe = parking, pokoje = room, komorki-lokatorskie = storage_unit, sala-weselna = wedding_hall, magazyny = warehouse, dzialki = plot, lokale = unit, kontenery = container. Every segment is optional and the remaining filters are passed as query parameters. When a query parameter contradicts the path, the path wins.

### Query rules

- Listings appear only once listingCategory, listingCity, listingCompanySlug or listingInvestmentSlug is given in the parameters or in the address path. Without any of them the response holds only the guide.
- Write parameter names exactly as below, with the same letter case (listingCity, not city or ListingCity). Values are case-insensitive: rent, RENT and Rent are the same.
- listingCategory and listingType also accept the slugs from the address path (mieszkania is apartment, na-wynajem is rent). listingCity and listingDistrict turn capital letters, Polish characters and spaces into the slug (Łódź is lodz, Bielsko Biała is bielsko-biala).
- A parameter marked “one value” is given once. Repeated with the same value it counts once. Repeated with different values, or with several comma-separated values, it is skipped entirely.
- A parameter marked “several values” takes more than one value: repeat it (listingRoomsCount=2&listingRoomsCount=3) or separate the values with a comma (listingRoomsCount=2,3). “Any of them matches” works as or, “must have all of them” works as and. One invalid value in the list skips the whole parameter.
- From and to pairs (price, area, floor) include both ends and either end can be given alone. When from is greater than to, the response has status 422 and names the wrong pair.
- Every value has the limit given below. A parameter that is unknown, has a value outside the list or limit, is repeated with different values, does not fit the chosen category or type, lacks a required parameter, or contradicts the path is skipped. The results are not filtered by it and its name goes to the “Warning: these parameters were skipped” line. Check that line after every query.
- When a parameter contradicts the address path (e.g. /mieszkania/warszawa.md?listingCity=krakow), the path wins and the parameter is skipped.
- Every result is one line: - [title](listing address): price | area | category | address. The same address with the .md suffix returns the full listing.
- Results are split into pages. Every response states the number of results, the page number and the total number of pages, and the “Next page of results” link leads to the next one. You can also set the page yourself with the page parameter. Open a listing's details by following its link with the .md suffix.
- One IP address can send at most 120 Markdown requests (.md addresses and pages asked for with the Accept: text/markdown header) within 60 seconds. Above that the response has status 429 and a Retry-After header with the seconds to wait.

### Parameters

Below, every parameter of /en/szukaj.md and of results addresses with the .md suffix has its label, how many values it takes, the categories and types it works in, its default and its allowed values with minimum and maximum.

Units: prices are gross amounts in PLN. For a sale it is the total price, for a long-term rental the rent per month, and for a short-term rental the price per day. Price filters and price sorting compare these amounts directly, so combine them with listingType, and for rentals also with listingContractType. Area is in m². Floor 0 is the ground floor, and negative values are underground levels.

- listingCity (City / Town; one value): city slug of 3 to 50 characters, e.g. warszawa, lodz, bielsko-biala; capital letters, Polish characters and spaces are turned into the slug, so Łódź works as lodz; list of cities: https://maszbox.pl/en/miasta.md; an unknown city gives 0 results and a warning
- listingDistrict (District / neighbourhood; one value): district slug of 3 to 50 characters in the city from listingCity, e.g. mokotow, praga-poludnie (districts are on the city page); turned into a slug like the city; requires listingCity; an unknown district is skipped
- locationRadius (Additional area (km); one value): radius in km from the city centre, one of: 2, 5, 10, 15, 30, 50, 80, 100; requires listingCity; with it listingDistrict is skipped
- listingCompanySlug (Company; one value): company slug of 6 to 50 characters from the list https://maszbox.pl/en/firmy.md; enough on its own to show listings; an unknown slug gives a 404 response with a message
- listingInvestmentSlug (Housing development; one value): housing estate slug of 3 to 255 characters from the list https://maszbox.pl/en/osiedla.md; enough on its own to show listings; an unknown slug gives a 404 response with a message
- listingCategory (Listing category; one value): apartment (Apartments), house (Houses), attic (Attics), basement (Basements), garage (Garages), parking (Parking spaces), room (Rooms), storage_unit (Storage units), wedding_hall (Wedding halls), warehouse (Warehouses), plot (Plots), unit (Units), container (Containers)
- listingType (Listing type; one value): rent (Rent), sale (Sale)
- listingContractType (Rental period; one value; only with listingType=rent): short_term (Short-term), long_term (Long-term)
- listingPriceFrom, listingPriceTo (Price from, Price to; one value each; range with both ends included; from must not be greater than to): number from 0 to 100000000; may have a decimal part after a dot, e.g. 4000.50
- listingAreaFrom, listingAreaTo (Area from, Area to; one value each; range with both ends included; from must not be greater than to): number from 0 to 999999999; may have a decimal part after a dot, e.g. 4000.50
- listingFloorLevelFrom, listingFloorLevelTo (Floor from, Floor to; one value each; range with both ends included; from must not be greater than to): whole number from -4 to 20
- listingRoomsCount (Number of rooms; several values (at most 10), any of them matches; only with listingCategory: apartment, house): whole number from 1 to 10
- listingFloorsCount (Number of floors; several values (at most 5), any of them matches; only with listingCategory: apartment, house): whole number from 1 to 5
- listingMarket (Market; one value; only with listingCategory: apartment, house): primary (Primary), secondary (Secondary)
- listingApartmentTypes (Building types; several values (at most 4), any of them matches; only with listingCategory: apartment): apartment_building (Apartment building), block (Block of flats), tenement (Tenement house), other (Other)
- listingHouseTypes (House types; several values (at most 6), any of them matches; only with listingCategory: house): detached (Detached), semi_detached (Semi-detached), terraced (Terraced), farmhouse (Farmhouse), holiday (Holiday home), other (Other)
- listingPlotTypes (Plot types; several values (at most 3), any of them matches; only with listingCategory: plot; only with listingType=rent): service (Service plot), forest (Forest plot), agricultural (Agricultural plot)
- listingPlotTypes (Plot types; several values (at most 5), any of them matches; only with listingCategory: plot; only with listingType=sale): building (Building plot), investment (Investment plot), recreational (Recreational plot), agricultural (Agricultural plot), forest (Forest plot)
- listingUnitTypes (Unit types; several values (at most 6), any of them matches; only with listingCategory: unit): conference_room (Conference room), office (Office), production (Production), retail (Retail), service (Service), warehouse (Warehouse)
- listingContainerTypes (Container types; several values (at most 6), any of them matches; only with listingCategory: container): marine (Marine container), modular_residential (Modular container), office_social (Office / social container), refrigerated (Refrigerated container), sanitary (Sanitary container), warehouse (Warehouse container)
- listingParkingTypes (Garage types; several values (at most 3), any of them matches; only with listingCategory: garage): detached (Detached), multilevel_lift (Multilevel with lift), motorcycle (For motorcycles)
- listingParkingTypes (Parking space types; several values (at most 4), any of them matches; only with listingCategory: parking): ground_place (Above-ground), underground (Underground), multilevel_lift (Multilevel with lift), motorcycle (For motorcycles)
- listingCondition (Condition; several values (at most 8), any of them matches): damaged (Damaged), finished (Finished), needs_renovation (Needs renovation), new (New), partially_finished (Partially finished), raw (Shell condition), renovated (Renovated), used (Used)
- listingSecurityOption (Security options; several values (at most 11), the listing must have all of them): alarm (Alarm), automatic_gate (Automatic gate), electronic_lock (Electronic lock), manual_gate (Manual gate), monitoring (Monitoring), padlock (Padlock), door_lock (Door lock), security (Security service), barrier (Barrier), parking_lock (Parking lock), remote_control (Remote control)
- listingUtilityOption (Utilities; several values (at most 5), the listing must have all of them): electricity (Electricity), gas (Gas), internet (Internet), sewage (Sewage), water (Water)
- listingComfortOption (Comfort options; several values (at most 6), the listing must have all of them): air_conditioning (Air conditioning), furnished (Furnished), heated (Heating), lighting (Lighting), parking (Parking), ventilation (Ventilation)
- listingEntryOption (Entry options; several values (at most 5), the listing must have all of them): driveway_gate (Driveway gate), elevator (Elevator), loading_ramp (Loading ramp), staircase (Staircase), street_entrance (Street-side entrance)
- listingUsageOption (Usage options; several values (at most 2), the listing must have all of them): car_access (Car access), tir_access (Truck access)
- listingAccess (Access; one value): access_24h (24/7 access), limited_hours (Access during limited hours)
- checkboxListingNegotiable (Listing price is negotiable; one value): only the value true turns the filter on; any other value or no parameter means no filter
- listingAvailableFrom (Listing availability start date; one value): date in the YYYY-MM-DD format, e.g. 2026-10-01; matches listings available on that day at the latest; a date that does not exist is skipped
- listingRentalDays (Number of rental days; one value; only with listingContractType=short_term): whole number from 1 to 1000; matches listings whose minimum rental period is at most this many days
- listingSort (Sorting; one value; default newest): newest (Newest), price_asc (Price ascending), price_desc (Price descending), area_asc (Area ascending), area_desc (Area descending); newest orders by date added, newest first; listings with the same date, price or area are ordered by listing ID; when sorting by area, listings without an area come last
- page (Pagination page; one value; default 1): page number, whole number from 1 to 10000; a number above the page count returns the last page
- limit (Pagination limit; one value; default 10): results per page, whole number from 1 to 50

### Parameters by category

Parameters without the “only with listingCategory” note work in every category. Below, each category lists the listing types it appears in and the parameters that work only in it. A category combined with a type it does not appear in gives 0 results and a warning.

- apartment (Apartments; rent and sale): listingRoomsCount, listingFloorsCount, listingMarket, listingApartmentTypes
- house (Houses; rent and sale): listingRoomsCount, listingFloorsCount, listingMarket, listingHouseTypes
- attic (Attics; rent only): no parameters of its own
- basement (Basements; rent only): no parameters of its own
- garage (Garages; rent and sale): listingParkingTypes
- parking (Parking spaces; rent and sale): listingParkingTypes
- room (Rooms; rent only): no parameters of its own
- storage_unit (Storage units; rent and sale): no parameters of its own
- wedding_hall (Wedding halls; rent and sale): no parameters of its own
- warehouse (Warehouses; rent and sale): no parameters of its own
- plot (Plots; rent and sale): listingPlotTypes
- unit (Units; rent and sale): listingUnitTypes
- container (Containers; rent and sale): listingContainerTypes

### Query examples

- Apartments for long-term rent in Warsaw, 2 or 3 rooms, up to 4000 PLN a month, cheapest first: https://maszbox.pl/en/szukaj.md?listingCategory=apartment&listingType=rent&listingContractType=long_term&listingCity=warszawa&listingRoomsCount=2,3&listingPriceTo=4000&listingSort=price_asc
- Detached garages for sale within 30 km of the centre of Kraków: https://maszbox.pl/en/szukaj.md?listingCategory=garage&listingType=sale&listingCity=krakow&locationRadius=30&listingParkingTypes=detached
- Building plots for sale from 1000 m² with electricity and water: https://maszbox.pl/en/szukaj.md?listingCategory=plot&listingType=sale&listingPlotTypes=building&listingAreaFrom=1000&listingUtilityOption=electricity,water
- Wedding halls for short-term rent for 2 days in Łódź: https://maszbox.pl/en/szukaj.md?listingCategory=wedding_hall&listingType=rent&listingContractType=short_term&listingRentalDays=2&listingCity=lodz
- Apartments for sale in Mokotów, Warsaw, on the primary market, with the category, type, city and district in the path: https://maszbox.pl/en/mieszkania/na-sprzedaz/warszawa/mokotow.md?listingMarket=primary
- Rental listings of one company (take the company slug from the list https://maszbox.pl/en/firmy.md): https://maszbox.pl/en/szukaj.md?listingCompanySlug=company-slug&listingType=rent