WG-Gesucht Rental Listings & Housing Requests

Find rooms, apartments, houses, and housing requests on wg-gesucht.de across Germany and nearby European countries with practical filters for location, budget, dates, size, amenities, and flatshare preferences. Collect clean rental-market data for relocation, property research, price comparisons, and housing alerts.

🚀 Get started

1. Open the Actor in Apify Console and choose Try for free.
2. Keep the prefilled location Berlin, or enter another city or area.
3. Select the listing type and add the filters that matter to you.
4. Start the run and review the results in the Dataset tab.

The default search looks for active shared-room offers in Berlin and returns up to 100 results. Use maxItems: 0 when you want all results allowed by your run.

You can start the Actor from Apify Console, the Apify API, or an automation connected to your rental-research workflow.

🎯 What you can find

• Available rooms, apartments, houses, and short-term rentals
• Housing requests from people looking for a home
• Listings filtered by rent, size, rooms, dates, furnishing, pets, and amenities
• Flatshares matched by household preferences, smoking rules, gender, and suitability
• New offers for relocation research, market monitoring, and price comparisons
• Public listing links, images, location information, costs, and published contact details

🧭 Choose a search area

Use one of these friendly search options:

• location: enter a city, district, or place such as Berlin or Munich. The Actor resolves the name to the closest matching search area.
• latitude, longitude, and radiusKm: search around a map point, such as a university, workplace, or neighborhood. When coordinates are provided, this search takes precedence over location.

The default location is Berlin, so a new run is ready to return results without extra setup.

📝 Input parameters

All fields are optional except type. Leave a filter empty when you do not want to restrict the search.

Input	Type	Default	Description
maxItems	integer	100	Maximum number of results. 0 collects all results allowed by the run.
location	text	Berlin	City, district, or place to search. Leave empty when using coordinates.
country	select	—	Limit location matching to Germany (de), Austria (at), Belgium (be), Switzerland (ch), Czechia (cz), Denmark (dk), France (fr), Luxembourg (lu), the Netherlands (nl), or Poland (pl), or leave as Any.
sortBy	select	—	Sort by newest, oldest, lowest rent, highest rent, smallest size, or largest size.
fetchDetails	boolean	false	Add the listing’s extended description, amenities, property information, and published contact details.
type	select	offers	Choose available listings (offers) or housing requests (requests).
propertyType	select	shared-room	Shared room, one-room apartment, apartment, or house.
rentalPeriod	select	any	Any period, long-term, short-term, or daily rental.
language	select	de	Preferred listing language: German or English.
latitude	number	—	Map latitude from -90 to 90. Use together with longitude and radiusKm.
longitude	number	—	Map longitude from -180 to 180. Use together with latitude and radiusKm.
radiusKm	integer	—	Search distance in kilometres around the coordinates.
includeDeactivated	boolean	false	Include offers that are no longer active.
minRent	integer	—	Minimum rent or total cost.
maxRent	integer	—	Maximum rent or total cost.
minRooms	number	—	Minimum number of rooms, from 2 to 9.5. Half-room values are supported.
maxRooms	number	—	Maximum number of rooms, from 2 to 9.5. Half-room values are supported.
minSize	integer	—	Minimum property size in square metres.
maxSize	integer	—	Maximum property size in square metres.
ageMin	integer	—	Minimum household age preference.
ageMax	integer	—	Maximum household age preference.
dateFrom	date	—	Earliest desired move-in date, formatted as YYYY-MM-DD.
dateTo	date	—	Latest desired move-in date, formatted as YYYY-MM-DD.
dateFromDeviation	integer	—	Move-in date flexibility in days after the earliest date.
dateToDeviation	integer	—	Move-in date flexibility in days before or after the latest date.
newOffersSince	select	—	Show listings added in the last 3 days, week, 2 or 3 weeks, month, 2 months, or 3 months.
furnished	select	—	Any furnishing, furnished, unfurnished, or partly furnished.
kitchen	select	—	Any kitchen status, kitchen present, or no kitchen.
hasBalcony	boolean	false	Require a balcony or terrace.
hasGarden	boolean	false	Require a garden.
hasKitchen	boolean	false	Require a kitchen.
accessible	boolean	false	Require accessible features.
imagesOnly	boolean	false	Return only results with photos.
onlineViewing	boolean	false	Require online viewing availability.
excludeContacted	boolean	false	Exclude listings already contacted by the account.
swap	select	—	Any swap status, swap available, or no swap.
swapOnly	boolean	false	Limit results to listings offering a home swap.
flatshareSuitability	select	—	Any suitability, suitable, or not suitable for a flatshare.
flatshareFriendly	boolean	false	Prefer listings marked as suitable for flatsharing.
flatshareTypes	multi-select	—	Choose platform tags such as students-only, female-only, male-only, business-people, workers-only, trainees, seniors-only, with-children, communal, mixed-gender, varied-age, vegetarian-vegan, LGBTQIA-friendly, room-for-help, single-parents-only, internationals-welcome, inclusive, functional, new-flatshare, not-specified, and non-communal.
petsAllowed	boolean	false	Require a listing that allows pets.
petPolicy	select	—	Any pet policy, pets allowed, or pets not allowed.
petsPresent	select	—	Any status, pets present, or no pets present in the household.
floorLevel	select	—	Ground, first through fifth, higher than fifth, cellar, basement, raised ground floor, or loft/attic.
gender	multi-select	—	Preferred genders named by the listing: female, male, diverse, or unspecified.
flatmateGender	select	—	Gender of current flatmates: any, female, male, diverse, or unspecified.
smoking	select	—	Smoker or non-smoker preference.
flatshareSmoking	select	—	Smoking anywhere, in the own room, on the balcony, or not at all.
myAge	integer	—	Your age for flatshare matching.
myGender	select	—	Your gender for flatshare matching: female, male, diverse, or unspecified.
minFlatshareSize	integer	—	Minimum number of current flatmates.
maxFlatshareSize	integer	—	Maximum number of current flatmates.

Example: Berlin room search

{
  "location": "Berlin",
  "type": "offers",
  "propertyType": "shared-room",
  "rentalPeriod": "long-term",
  "maxRent": 850,
  "minSize": 12,
  "hasKitchen": true,
  "imagesOnly": true,
  "newOffersSince": "last-week",
  "sortBy": "newest",
  "maxItems": 50
}

Example: coordinate search near a workplace

{
  "latitude": 52.520008,
  "longitude": 13.404954,
  "radiusKm": 5,
  "propertyType": "apartment",
  "minRooms": 2,
  "maxRooms": 3,
  "maxRent": 2200,
  "onlineViewing": true,
  "maxItems": 25
}

Example: housing request research

{
  "type": "requests",
  "location": "Hamburg",
  "rentalPeriod": "long-term",
  "minSize": 15,
  "dateFrom": "2026-10-01",
  "dateFromDeviation": 14,
  "flatshareSuitability": "suitable",
  "sortBy": "newest",
  "maxItems": 100
}

📊 Output

Each result keeps the public listing information in a convenient, analysis-ready format.

Field	Meaning
offer_id / request_id	Public listing or housing-request identifier, when available.
offer_title / request_title	Listing or request title.
href / url	Public page links.
sized / small / thumb	Available full-size and preview image links from the search results.
town_name / city_name / country_code	Town, city, and country.
street / postcode / district_custom	Published address and district information.
geo_latitude / geo_longitude	Published map coordinates.
category / rent_type	Property category and rental period.
rent_costs / utility_costs / other_costs / total_costs	Cost breakdown.
property_size / number_of_rooms	Size and room count.
available_from_date / available_to_date	Availability dates.
furnished / garden / kitchen_availability	Main property amenities.
pets_allowed / online_tour	Pet and online-viewing information.
user_data.public_name / user_data.company_name	Published contact name or company.
offer_telephone / offer_mobile	Published phone numbers, when provided.
_details	Extended information added when fetchDetails is enabled.

Example result:

{
  "offer_id": "13914534",
  "offer_title": "Bright room near Prenzlauer Berg",
  "url": "https://www.wg-gesucht.de/13914534.html",
  "city_name": "Berlin",
  "district_custom": "Prenzlauer Berg",
  "postcode": "10437",
  "property_size": "13",
  "rent_costs": "550",
  "total_costs": "550",
  "available_from_date": "15.09.2026",
  "furnished": "1",
  "pets_allowed": "1",
  "sized": "https://img.wg-gesucht.de/media/example.sized.jpg",
  "small": "https://img.wg-gesucht.de/media/example.small.jpg",
  "thumb": "https://img.wg-gesucht.de/media/example.thumb.jpg",
  "_details": {
    "description": "Quiet room in a friendly shared flat",
    "amenities": ["balcony", "washing machine"]
  }
}

💳 Pricing

Runs follow the pricing shown on the Actor page. Choosing more results or enabling extended details may use more of your run allowance, so start with a small limit while refining filters.

💡 Tips and common recipes

• Start with maxItems: 10 while tuning filters, then increase it for a larger market view.
• Use newOffersSince together with sortBy: "newest" to monitor recent opportunities.
• Use imagesOnly: true when creating a visual housing catalogue.
• Use type: "requests" to find people seeking accommodation rather than available homes.
• Use coordinates and radiusKm to compare listings around a campus, office, or transit hub.
• Enable fetchDetails when descriptions and extended amenities matter.

⚖️ Legal and ethical considerations

• Use only information that is publicly available and follow WG-Gesucht’s terms and applicable laws.
• Do not use published contact details for unsolicited messages or bulk outreach.
• Do not use housing information for unlawful discrimination or sensitive profiling.
• Respect access limits, keep collected data secure, and remove personal data when it is no longer needed.
• This Actor is an independent tool and is not affiliated with or endorsed by WG-Gesucht.

❓ FAQ

Does the default input return data?

Yes. Berlin is prefilled, and the default search is configured for active shared-room offers.

Can I search with only a location?

Yes. Enter a city, district, or place in location. The Actor resolves it to the closest matching search area.

Can I search around coordinates?

Yes. Provide latitude, longitude, and radiusKm together. Coordinate searches take precedence over a named location.

What does maxItems: 0 do?

It collects all results allowed by the run. Use a positive number when you want a predictable smaller result set.

Why are some contact or address fields empty?

WG-Gesucht only publishes information permitted by each advertiser’s privacy settings. Empty values are preserved as provided.

What does fetchDetails add?

It adds extended descriptions, amenities, property information, and published contact details where available. Individual missing details do not remove the original result.

Can I search housing requests?

Yes. Set type to requests; request results use request-specific fields where available.

🛟 Support

For questions, suggestions, or help with a run, contact igolaizola.com/#contact.