WG-Gesucht Flatshare & Room Listings Scraper

Scrape shared-flat rooms, apartments and single-room listings from WG-Gesucht.de — Germany's largest platform for flatshares (Wohngemeinschaften), room rentals and apartment listings. Get price, size, room count, district, availability date, photo and direct listing URL for 14 major German cities.

What does it scrape?

This actor scrapes WG-Gesucht's public search-results pages, returning:

• Listing identity: listing ID, title, direct listing URL
• Pricing: monthly rent in EUR
• Layout: living space in m², room count (or WG flatmate count for shared-flat rooms)
• Location: city, district/neighborhood, street
• Availability: move-in date as published
• Media: primary listing photo URL
• Poster info: verification status, poster/agency name, last-online status
• Flatmates: current flatmate gender composition (for shared-flat rooms)
• Badges: listing perks such as "Online-Besichtigung" (virtual tour available)

Input

Field	Type	Description
city	string	German city to search (required) — see dropdown below
listingType	string	wg_zimmer (shared flat room), wohnungen (apartments), or einzelzimmer (1-room apartment)
maxRentEur	integer	Only return listings at or below this monthly rent in EUR
minRooms	integer	Only return listings with at least this many rooms / WG slots
maxItems	integer	Max listings to return (default 25, max 100)

Supported cities

Berlin, München, Hamburg, Köln, Frankfurt am Main, Stuttgart, Düsseldorf, Leipzig, Dortmund, Essen, Nürnberg, Dresden, Hannover, Bremen.

Output

Each record contains:

{
  "listingId": "10056647",
  "title": "URBANELITE.COM // No deposit! // Friedrichshain prime location // furnished luxury room",
  "city": "Berlin",
  "neighborhood": "Friedrichshain",
  "street": "Revaler Straße",
  "price": 799,
  "sizeSqm": 15,
  "rooms": 6,
  "roomType": "6er WG",
  "availableFrom": "01.08.2026",
  "imageUrl": "https://img.wg-gesucht.de/media/up/2023/19/a6789ac82ed5f06e188adf06f19de8a3d5c9dc709750134670ecbd87fa0c7ee9_WhatsApp_Image_2023_05_03_at_11.32.31_AM.small.jpeg",
  "listingUrl": "https://www.wg-gesucht.de/wg-zimmer-in-Berlin-Friedrichshain.10056647.html",
  "sourceUrl": "https://www.wg-gesucht.de/wg-zimmer-in-Berlin.8.0.1.0.html",
  "scrapedAt": "2026-07-01T01:00:00+00:00",
  "recordType": "wg_zimmer",
  "isVerified": true,
  "posterName": "Urban Elite",
  "lastOnlineText": "Online: 10 Minuten",
  "flatmateGenderComposition": {"female": 1, "male": 1},
  "badges": ["Online-Besichtigung"]
}

isVerified is always present (true/false). posterName, lastOnlineText, flatmateGenderComposition and badges are included whenever WG-Gesucht's listing card exposes that data (gender composition only applies to shared-flat rooms with visible flatmate counts; badges only appear when the listing has a perk like a virtual tour).

FAQs

Does it require a WG-Gesucht account, login or cookies? No. This actor scrapes WG-Gesucht's public listing search pages without any authentication, cookies, or paid proxy.

How many listings can I get per run? Up to 100 listings per run. WG-Gesucht shows roughly 20-30 listings per page and the actor paginates automatically until maxItems is reached.

Can I filter by price or room count? Yes. Use maxRentEur to cap the monthly rent in EUR, and minRooms to require a minimum number of rooms (for apartments) or flatmate slots (for shared-flat rooms).

What does rooms mean for a WG-Zimmer (shared flat room) listing? WG-Gesucht labels shared flats by total flatmate count (e.g. "6er WG" = a 6-person shared flat). The rooms field reflects that count so filtering behaves consistently across listing types; the original label is preserved in roomType.

What's the difference between Wohnungen and Einzelzimmer? Wohnungen returns whole apartments of any size. Einzelzimmer returns WG-Gesucht's "1-Zimmer-Wohnung" category — self-contained single-room apartments, typically for one person.

Which cities are supported? 14 major German cities including Berlin, München, Hamburg, Köln and Frankfurt am Main. Select from the dropdown in the input schema.

Are utilities included in the price? The price shown is the listed monthly rent from WG-Gesucht — utilities (Nebenkosten) may or may not be included depending on the individual listing's own description.

Is the scraper affected by bot detection? WG-Gesucht occasionally shows a one-time human-verification page to IPs that request pages unusually fast. The actor detects this automatically and retries through Apify's free datacenter proxy pool, so runs stay reliable without any paid proxy.