# Ogłoszenia na wynajem na platformie Maszbox.pl

Ogłoszenia pokazujemy dopiero po wybraniu kategorii (listingCategory) albo miasta (listingCity). Dodaj je do parametrów, np. https://maszbox.pl/szukaj.md?listingCity=warszawa&listingCategory=apartment, albo wejdź w adres kategorii i miasta, np. https://maszbox.pl/mieszkania/warszawa.md.

## Ogłoszenia na wynajem

Wybierz kategorię, aby zobaczyć przestrzenie dostępne na wynajem. Możesz też skorzystać z wyszukiwarki, aby zawęzić oferty do konkretnej lokalizacji.

- [Mieszkania](https://maszbox.pl/mieszkania/na-wynajem.md)
- [Domy](https://maszbox.pl/domy/na-wynajem.md)
- [Działki](https://maszbox.pl/dzialki/na-wynajem.md)
- [Garaże](https://maszbox.pl/garaze/na-wynajem.md)
- [Komórki lokatorskie](https://maszbox.pl/komorki-lokatorskie/na-wynajem.md)
- [Kontenery](https://maszbox.pl/kontenery/na-wynajem.md)
- [Lokale](https://maszbox.pl/lokale/na-wynajem.md)
- [Magazyny](https://maszbox.pl/magazyny/na-wynajem.md)
- [Miejsca postojowe](https://maszbox.pl/miejsca-postojowe/na-wynajem.md)
- [Piwnice](https://maszbox.pl/piwnice/na-wynajem.md)
- [Pokoje](https://maszbox.pl/pokoje/na-wynajem.md)
- [Sale weselne](https://maszbox.pl/sala-weselna/na-wynajem.md)
- [Strychy](https://maszbox.pl/strychy/na-wynajem.md)

## Pytania i odpowiedzi

### Jak działa wyszukiwarka powierzchni?

Wpisz miasto lub dzielnicę i wybierz kategorię powierzchni. Wyniki zawęzisz promieniem od wybranej lokalizacji oraz filtrami dodatkowymi - typem oferty, stanem powierzchni, rodzajem dostępu czy formą umowy.

### Jakie kategorie powierzchni są dostępne?

Do wyboru są mieszkania, domy, pokoje, strychy, piwnice, komórki lokatorskie, garaże i miejsca parkingowe, magazyny, kontenery, lokale użytkowe, sale weselne oraz działki - zarówno na wynajem, jak i na sprzedaż.

### Czy mogę szukać w konkretnej dzielnicy?

Tak. Po wybraniu miasta możesz wskazać konkretną dzielnicę albo zamiast tego ustawić promień wyszukiwania wokół miasta, ale nie oba naraz.

### Czy przeglądanie ogłoszeń wymaga konta?

Nie. Przeglądanie ogłoszeń i kontakt z ogłoszeniodawcą nie wymagają konta. Konto potrzebne jest dopiero, gdy chcesz dodać własne ogłoszenie.

### Czy mogę przeglądać oferty na mapie?

Tak. Nad wynikami wyszukiwania znajdziesz mapę z wszystkimi ofertami z bieżących filtrów. Znaczniki blisko siebie łączą się w grupy - po kliknięciu grupy zobaczysz listę ogłoszeń z tego miejsca i przejdziesz prosto do wybranego. Na telefonie mapę otwiera przycisk „Pokaż na mapie”.

## Jak przeszukiwać ogłoszenia

Ogłoszenia przeszukasz bez JavaScriptu: https://maszbox.pl/szukaj.md zwraca wyniki w formacie Markdown. Agentowi najprościej jest podać wszystkie filtry jako parametry zapytania do tego adresu. Każdy adres wyników działa też z końcówką .md, a zwykły adres strony zwraca Markdown, gdy zapytanie ma nagłówek Accept: text/markdown.

Adres wyników składa się z segmentów kategoria/typ/miasto/dzielnica, np. /mieszkania/na-sprzedaz/warszawa/bemowo. Typ to na-wynajem (rent) lub na-sprzedaz (sale), a slugi kategorii odpowiadają wartościom listingCategory: 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. Każdy segment jest opcjonalny, a pozostałe filtry trafiają do parametrów zapytania. Gdy parametr zapytania kłóci się ze ścieżką, obowiązuje ścieżka.

### Zasady zapytań

- Lista ogłoszeń pojawia się dopiero po podaniu listingCategory, listingCity, listingCompanySlug albo listingInvestmentSlug w parametrach albo w ścieżce adresu. Bez żadnego z nich odpowiedź zawiera tylko instrukcję.
- Nazwy parametrów pisz dokładnie tak jak poniżej, z tą samą wielkością liter (listingCity, a nie city ani ListingCity). W wartościach wielkość liter nie ma znaczenia: rent, RENT i Rent to to samo.
- listingCategory i listingType przyjmują też slugi ze ścieżki adresu (mieszkania to apartment, na-wynajem to rent). listingCity i listingDistrict zamieniają wielkie litery, polskie znaki i spacje na slug (Łódź to lodz, Bielsko Biała to bielsko-biala).
- Parametr z dopiskiem „jedna wartość” podajesz raz. Powtórzony z tą samą wartością liczy się raz. Powtórzony z różnymi wartościami albo z kilkoma wartościami po przecinku jest pomijany w całości.
- Parametr z dopiskiem „wiele wartości” przyjmuje kilka wartości: powtórz go (listingRoomsCount=2&listingRoomsCount=3) albo oddziel wartości przecinkiem (listingRoomsCount=2,3). „Pasuje dowolna” działa jak lub, „musi mieć wszystkie” działa jak i. Jedna nieprawidłowa wartość na liście powoduje pominięcie całego parametru.
- Pary od i do (cena, powierzchnia, piętro) obejmują obie granice i można podać tylko jedną z nich. Gdy od jest większe niż do, odpowiedź ma status 422 i nazywa błędną parę.
- Każda wartość ma limit podany niżej. Parametr nieznany, z wartością spoza listy lub limitu, powtórzony z różnymi wartościami, niepasujący do wybranej kategorii lub typu, bez wymaganego parametru albo sprzeczny ze ścieżką jest pomijany. Wyniki nie są nim filtrowane, a jego nazwa trafia do linii „Uwaga: pominięto parametry”. Sprawdzaj tę linię po każdym zapytaniu.
- Gdy parametr kłóci się ze ścieżką adresu (np. /mieszkania/warszawa.md?listingCity=krakow), obowiązuje ścieżka, a parametr jest pomijany.
- Każdy wynik to jedna linia: - [tytuł](adres ogłoszenia): cena | powierzchnia | kategoria | adres. Ten sam adres z końcówką .md zwraca pełny opis ogłoszenia.
- Wyniki są podzielone na strony. Każda odpowiedź podaje liczbę wyników, numer strony i liczbę wszystkich stron, a link „Następna strona wyników” prowadzi do kolejnej. Numer strony możesz też ustawić sam parametrem page. Szczegóły ogłoszenia otworzysz, wchodząc w jego link z końcówką .md.
- Z jednego adresu IP można wysłać najwyżej 120 zapytań o Markdown (adresy .md i strony z nagłówkiem Accept: text/markdown) w ciągu 60 sekund. Po przekroczeniu odpowiedź ma status 429 i nagłówek Retry-After z liczbą sekund do odczekania.

### Parametry

Każdy parametr /szukaj.md i adresów wyników z końcówką .md ma poniżej etykietę, liczbę przyjmowanych wartości, kategorie i typy, w których działa, wartość domyślną oraz dozwolone wartości z minimum i maksimum.

Jednostki: ceny są w złotych brutto. Przy sprzedaży to cena całkowita, przy najmie długoterminowym czynsz za miesiąc, a przy najmie krótkoterminowym cena za dzień. Filtry i sortowanie po cenie porównują te kwoty wprost, więc łącz je z listingType, a przy najmie także z listingContractType. Powierzchnia jest w m². Piętro 0 to parter, a wartości ujemne to poziomy podziemne.

- listingCity (Miasto / Miejscowość; jedna wartość): slug miasta od 3 do 50 znaków, np. warszawa, lodz, bielsko-biala; wielkie litery, polskie znaki i spacje są zamieniane na slug, więc Łódź działa jak lodz; lista miast: https://maszbox.pl/miasta.md; nieznane miasto daje 0 wyników i ostrzeżenie
- listingDistrict (Dzielnica / osiedle; jedna wartość): slug dzielnicy od 3 do 50 znaków w mieście z listingCity, np. mokotow, praga-poludnie (dzielnice są na stronie miasta); zamieniany na slug tak jak miasto; wymaga listingCity; nieznana dzielnica jest pomijana
- locationRadius (Dodatkowy obszar (km); jedna wartość): promień w km od środka miasta, jedna z wartości: 2, 5, 10, 15, 30, 50, 80, 100; wymaga listingCity; przy nim listingDistrict jest pomijany
- listingCompanySlug (Firma; jedna wartość): slug firmy od 6 do 50 znaków z listy https://maszbox.pl/firmy.md; sam wystarcza do pokazania ogłoszeń; nieznany slug daje odpowiedź 404 z komunikatem
- listingInvestmentSlug (Osiedle; jedna wartość): slug osiedla od 3 do 255 znaków z listy https://maszbox.pl/osiedla.md; sam wystarcza do pokazania ogłoszeń; nieznany slug daje odpowiedź 404 z komunikatem
- listingCategory (Kategoria ogłoszenia; jedna wartość): apartment (Mieszkania), house (Domy), attic (Strychy), basement (Piwnice), garage (Garaże), parking (Miejsca postojowe), room (Pokoje), storage_unit (Komórki lokatorskie), wedding_hall (Sale weselne), warehouse (Magazyny), plot (Działki), unit (Lokale), container (Kontenery)
- listingType (Typ ogłoszenia; jedna wartość): rent (Wynajem), sale (Sprzedaż)
- listingContractType (Okres najmu; jedna wartość; tylko przy listingType=rent): short_term (Krótkoterminowe), long_term (Długoterminowe)
- listingPriceFrom, listingPriceTo (Cena od, Cena do; każdy po jednej wartości; zakres z obiema granicami włącznie; od nie może być większe niż do): liczba od 0 do 100000000; może mieć część dziesiętną po kropce, np. 4000.50
- listingAreaFrom, listingAreaTo (Powierzchnia od, Powierzchnia do; każdy po jednej wartości; zakres z obiema granicami włącznie; od nie może być większe niż do): liczba od 0 do 999999999; może mieć część dziesiętną po kropce, np. 4000.50
- listingFloorLevelFrom, listingFloorLevelTo (Piętro od, Piętro do; każdy po jednej wartości; zakres z obiema granicami włącznie; od nie może być większe niż do): liczba całkowita od -4 do 20
- listingRoomsCount (Liczba pokoi; wiele wartości (najwyżej 10), pasuje dowolna z nich; tylko przy listingCategory: apartment, house): liczba całkowita od 1 do 10
- listingFloorsCount (Liczba kondygnacji; wiele wartości (najwyżej 5), pasuje dowolna z nich; tylko przy listingCategory: apartment, house): liczba całkowita od 1 do 5
- listingMarket (Rynek; jedna wartość; tylko przy listingCategory: apartment, house): primary (Pierwotny), secondary (Wtórny)
- listingApartmentTypes (Rodzaj zabudowy; wiele wartości (najwyżej 4), pasuje dowolna z nich; tylko przy listingCategory: apartment): apartment_building (Apartamentowiec), block (Blok), tenement (Kamienica), other (Pozostały)
- listingHouseTypes (Rodzaj zabudowy; wiele wartości (najwyżej 6), pasuje dowolna z nich; tylko przy listingCategory: house): detached (Wolnostojący), semi_detached (Bliźniak), terraced (Szeregowiec), farmhouse (Gospodarstwo), holiday (Letniskowy), other (Pozostały)
- listingPlotTypes (Typy działek; wiele wartości (najwyżej 3), pasuje dowolna z nich; tylko przy listingCategory: plot; tylko przy listingType=rent): service (Usługowa), forest (Leśna), agricultural (Rolna)
- listingPlotTypes (Typy działek; wiele wartości (najwyżej 5), pasuje dowolna z nich; tylko przy listingCategory: plot; tylko przy listingType=sale): building (Budowlana), investment (Inwestycyjna), recreational (Rekreacyjna), agricultural (Rolna), forest (Leśna)
- listingUnitTypes (Typy lokali; wiele wartości (najwyżej 6), pasuje dowolna z nich; tylko przy listingCategory: unit): conference_room (Sala konferencyjna), office (Biurowy), production (Produkcyjny), retail (Handlowy), service (Usługowy), warehouse (Magazynowy)
- listingContainerTypes (Typy kontenerów; wiele wartości (najwyżej 6), pasuje dowolna z nich; tylko przy listingCategory: container): marine (Morski), modular_residential (Modułowy), office_social (Biurowo-socjalny), refrigerated (Chłodniczy), sanitary (Sanitarny), warehouse (Magazynowy)
- listingParkingTypes (Typy garażu; wiele wartości (najwyżej 3), pasuje dowolna z nich; tylko przy listingCategory: garage): detached (Wolnostojący), multilevel_lift (Wielopoziomowy z windą), motorcycle (Na motocykle)
- listingParkingTypes (Typy miejsca postojowego; wiele wartości (najwyżej 4), pasuje dowolna z nich; tylko przy listingCategory: parking): ground_place (Naziemne), underground (Podziemne), multilevel_lift (Wielopoziomowy z windą), motorcycle (Na motocykle)
- listingCondition (Stan; wiele wartości (najwyżej 8), pasuje dowolna z nich): damaged (Uszkodzony), finished (Wykończony), needs_renovation (Do remontu), new (Nowy), partially_finished (Częściowo wykończony), raw (Stan surowy), renovated (Po remoncie), used (Używany)
- listingSecurityOption (Opcje bezpieczeństwa; wiele wartości (najwyżej 11), ogłoszenie musi mieć wszystkie): alarm (Alarm), automatic_gate (Brama automatyczna), electronic_lock (Zamek elektroniczny), manual_gate (Brama manualna), monitoring (Monitoring), padlock (Kłódka), door_lock (Zamek na klucze), security (Ochrona), barrier (Szlaban), parking_lock (Blokada parkingowa), remote_control (Pilot zdalnego sterowania)
- listingUtilityOption (Media; wiele wartości (najwyżej 5), ogłoszenie musi mieć wszystkie): electricity (Prąd), gas (Gaz), internet (Internet), sewage (Kanalizacja), water (Woda)
- listingComfortOption (Opcje komfortu; wiele wartości (najwyżej 6), ogłoszenie musi mieć wszystkie): air_conditioning (Klimatyzacja), furnished (Umeblowane), heated (Ogrzewanie), lighting (Oświetlenie), parking (Parking), ventilation (Wentylacja)
- listingEntryOption (Opcje wejścia; wiele wartości (najwyżej 5), ogłoszenie musi mieć wszystkie): driveway_gate (Brama wjazdowa), elevator (Winda), loading_ramp (Rampa załadunkowa), staircase (Klatka schodowa), street_entrance (Wejście od strony ulicy)
- listingUsageOption (Opcje użytkowania; wiele wartości (najwyżej 2), ogłoszenie musi mieć wszystkie): car_access (Dostęp dla samochodu), tir_access (Dostęp dla ciężarówki)
- listingAccess (Dostęp; jedna wartość): access_24h (Dostęp przez całą dobę), limited_hours (Dostęp w ograniczonych godzinach)
- checkboxListingNegotiable (Cena w ogłoszeniu podlega negocjacji; jedna wartość): tylko wartość true włącza filtr; inna wartość albo brak parametru oznacza brak filtra
- listingAvailableFrom (Data rozpoczęcia dostępności ogłoszenia; jedna wartość): data w formacie RRRR-MM-DD, np. 2026-10-01; pasują ogłoszenia dostępne najpóźniej od tego dnia; nieistniejąca data jest pomijana
- listingRentalDays (Liczba dni do wynajmu; jedna wartość; tylko przy listingContractType=short_term): liczba całkowita od 1 do 1000; pasują ogłoszenia, których minimalny okres najmu nie przekracza tej liczby dni
- listingSort (Sortowanie; jedna wartość; domyślnie newest): newest (Najnowsze), price_asc (Cena rosnąco), price_desc (Cena malejąco), area_asc (Powierzchnia rosnąco), area_desc (Powierzchnia malejąco); newest układa od najnowszych według daty dodania; przy tej samej dacie, cenie albo powierzchni kolejność ustala ID ogłoszenia; przy sortowaniu po powierzchni ogłoszenia bez podanej powierzchni są na końcu
- page (Strona paginacji; jedna wartość; domyślnie 1): numer strony, liczba całkowita od 1 do 10000; numer większy niż liczba stron zwraca ostatnią stronę
- limit (Limit paginacji; jedna wartość; domyślnie 10): liczba wyników na stronie, liczba całkowita od 1 do 50

### Parametry według kategorii

Parametry bez dopisku „tylko przy listingCategory” działają we wszystkich kategoriach. Poniżej przy każdej kategorii są typy ogłoszeń, w których występuje, i parametry działające tylko w niej. Kategoria z typem, w którym nie występuje, daje 0 wyników i ostrzeżenie.

- apartment (Mieszkania; wynajem i sprzedaż): listingRoomsCount, listingFloorsCount, listingMarket, listingApartmentTypes
- house (Domy; wynajem i sprzedaż): listingRoomsCount, listingFloorsCount, listingMarket, listingHouseTypes
- attic (Strychy; tylko wynajem): bez własnych parametrów
- basement (Piwnice; tylko wynajem): bez własnych parametrów
- garage (Garaże; wynajem i sprzedaż): listingParkingTypes
- parking (Miejsca postojowe; wynajem i sprzedaż): listingParkingTypes
- room (Pokoje; tylko wynajem): bez własnych parametrów
- storage_unit (Komórki lokatorskie; wynajem i sprzedaż): bez własnych parametrów
- wedding_hall (Sale weselne; wynajem i sprzedaż): bez własnych parametrów
- warehouse (Magazyny; wynajem i sprzedaż): bez własnych parametrów
- plot (Działki; wynajem i sprzedaż): listingPlotTypes
- unit (Lokale; wynajem i sprzedaż): listingUnitTypes
- container (Kontenery; wynajem i sprzedaż): listingContainerTypes

### Przykłady zapytań

- Mieszkania na wynajem długoterminowy w Warszawie, 2 lub 3 pokoje, do 4000 zł miesięcznie, od najtańszych: https://maszbox.pl/szukaj.md?listingCategory=apartment&listingType=rent&listingContractType=long_term&listingCity=warszawa&listingRoomsCount=2,3&listingPriceTo=4000&listingSort=price_asc
- Garaże wolnostojące na sprzedaż do 30 km od środka Krakowa: https://maszbox.pl/szukaj.md?listingCategory=garage&listingType=sale&listingCity=krakow&locationRadius=30&listingParkingTypes=detached
- Działki budowlane na sprzedaż od 1000 m² z prądem i wodą: https://maszbox.pl/szukaj.md?listingCategory=plot&listingType=sale&listingPlotTypes=building&listingAreaFrom=1000&listingUtilityOption=electricity,water
- Sale weselne na wynajem krótkoterminowy na 2 dni w Łodzi: https://maszbox.pl/szukaj.md?listingCategory=wedding_hall&listingType=rent&listingContractType=short_term&listingRentalDays=2&listingCity=lodz
- Mieszkania na sprzedaż na Mokotowie w Warszawie z rynku pierwotnego, z kategorią, typem, miastem i dzielnicą w ścieżce: https://maszbox.pl/mieszkania/na-sprzedaz/warszawa/mokotow.md?listingMarket=primary
- Ogłoszenia na wynajem jednej firmy (slug firmy weź z listy https://maszbox.pl/firmy.md): https://maszbox.pl/szukaj.md?listingCompanySlug=slug-firmy&listingType=rent