WG-Gesucht Scraper — Extract German Flatshare & Rental Listings

Extract WG-Zimmer flatshare and 1-Zimmer-Wohnung listings from WG-Gesucht.de, Germany's largest room-sharing marketplace, for rental price monitoring, student accommodation research, and German housing market analysis.

Main Use Cases

• WG-Zimmer price monitoring across Berlin, München, Hamburg, Köln, Frankfurt and 200+ German cities
• Student accommodation research — the platform's core audience is students looking for flatshare rooms
• Building structured flatshare databases for German housing market analysis and Mietspiegel-style research
• Relocation support for employees and internationals moving to German cities
• 1-Zimmer-Wohnung and studio apartment extraction for rental market comparison
• New listing alerts — track newly published rooms and their asking rents over time

How It Works

The actor runs a Cheerio crawler over the publicly available, server-rendered search pages of WG-Gesucht.de. In basic mode it extracts the full listing card of every search result (rent, size, district, availability, contact name). In full mode it additionally opens each listing detail page to capture cost breakdowns (deposit, utilities, buyout), photos, full description and the advertiser's phone number.

German number formats are parsed automatically: 1.234,56 € becomes the number 1234.56, so rent comparisons and price analysis work without manual cleaning. Pagination is followed automatically for every search URL you provide.

Extract Flatshare Listings For German Housing Market Research

Every WG-Zimmer listing is returned with structured fields: rent in euros, room size in m², type of WG (2er WG, 3er WG, …), city, district, street, availability date and the advertiser's public name. The full mode adds deposit, utilities, buyout amount, room photos and telephone contact.

Typical outputs from a real test run:

City	District	Rent	Size	Type
Berlin	Lichterfelde	400 €	26 m²	8er WG
München	Bogenhausen	795 €	13 m²	4er WG
Hamburg	Winterhude	700 €	15 m²	2er WG
Köln	Sülz	640 €	18 m²	WG
Halle (Saale)	Nördliche Innenstadt	180 €	20 m²	6er WG

Monitor WG-Zimmer Prices Across German Cities

Average warm WG rents in major German cities (Moses Mendelssohn Institute Mietspiegel, 2026, via Studis Online):

City	Average warm WG rent
München	800 €
Frankfurt am Main	694 €
Berlin	650 €
Hamburg	650 €
Köln	620 €

Running this actor weekly on city search URLs produces a time series of actual asking rents — a ground-truth dataset for Mietspiegel comparisons, neighborhood trend detection and budget planning for students and tenants.

Build A Student Accommodation Database

WG-Gesucht.de is where most German students find their first WG-Zimmer. Collect the full flatshare offering of a university city — including WG type, room size, availability date and rent — and build your own student housing database for university services, relocation offices or dormitory planning research.

Extract 1-Zimmer-Wohnung & Apartment Listings

The same crawler works on the 1-zimmer-wohnungen category of WG-Gesucht.de. Pass a category search URL (e.g. 1-zimmer-wohnungen-in-Muenchen.91.1.1.0.html) and get studio apartments with rent, size, district and contact data. Useful for comparing studio vs flatshare prices in the same city.

Input: Configure Your WG-Gesucht Search

Field	Type	Required	Default	Notes
startUrls	array of objects	✅	—	WG-Gesucht search/listing page URLs. The actor follows pagination automatically.
maxItems	integer	—	50	Maximum number of listings to extract per run.
detailLevel	enum full / basic	—	basic	basic scrapes search-result cards only; full opens each listing page for contact data, costs and photos.
proxyConfiguration	object	—	{ "useApifyProxy": true }	Apify proxy with automatic retries; works without configuration.

Example startUrls for major cities (verified against live WG-Gesucht.de pages):

[
  { "url": "https://www.wg-gesucht.de/wg-zimmer-in-Berlin.8.0.1.0.html" },
  { "url": "https://www.wg-gesucht.de/wg-zimmer-in-Muenchen.90.0.1.0.html" },
  { "url": "https://www.wg-gesucht.de/wg-zimmer-in-Hamburg.55.0.1.0.html" },
  { "url": "https://www.wg-gesucht.de/wg-zimmer-in-Koeln.73.0.1.0.html" },
  { "url": "https://www.wg-gesucht.de/wg-zimmer-in-Frankfurt-am-Main.41.0.1.0.html" }
]

Output: Flatshare Listings With Rent, Size & Contact Data

basic mode dataset fields:

Field	Description
listingId	WG-Gesucht listing identifier
title	Listing title
url	Direct link to the listing
rent	Rent in euros (German format parsed: 640 for 640 €)
size	Room size in m²
availableFrom	Availability date or date range
wgType	Type of WG (e.g. 3er WG, 6er WG)
city	City of the listing
district	District/neighborhood
street	Street address
contactName	Advertiser's public name
detailLevel	basic or full

full mode additionally returns (per listing page): costs.rent, costs.utilities, costs.otherCosts, costs.deposit, costs.buyout, totalRent, roomSize, apartmentSize, wgTypes, wgDetails, objectDetails, photos, description, locationDescription, wgLifeDescription, otherDescription, and contact.telephone / contact.mobile.

Example Input

{
  "startUrls": [
    { "url": "https://www.wg-gesucht.de/wg-zimmer-in-Berlin.8.0.1.0.html" }
  ],
  "maxItems": 20,
  "detailLevel": "basic",
  "proxyConfiguration": { "useApifyProxy": true }
}

Example Output

[
  {
    "listingId": 13104000,
    "title": "Gemütliches WG-Zimmer in heller Altbauwohnung, zentral und ruhig",
    "url": "https://www.wg-gesucht.de/wg-zimmer-in-Berlin-Lichterfelde.13104000.html",
    "rent": 400,
    "size": 26,
    "availableFrom": "01.10.2026",
    "wgType": "8er WG",
    "city": "Berlin",
    "district": "Lichterfelde",
    "street": "Königsberger Straße 30",
    "contactName": "Julia",
    "detailLevel": "basic"
  }
]

Integrations And Automation For Recurring Rent Monitoring

• Apify API — run the actor programmatically from any application
• Webhooks — receive a push notification whenever a new run finishes
• Zapier / Make / Pipedream — connect dataset output to spreadsheets, Slack or databases
• Scheduled runs — set a weekly or monthly schedule for continuous rent time series. Running regularly also improves the actor's Apify Store recommendation signals.

Recommended schedule: weekly for price monitoring (rents move slowly), daily for new-listing alerts.

Related Actors

• WG-Gesucht Property Scraper — the largest WG-Gesucht actor on Apify; property and flatshare search with multiple modes
• WG-Gesucht Scraper — flatshare listing extraction with contact details
• Kleinanzeigen Scraper — German classifieds including real estate and rentals for cross-portal comparison
• ImmoScout24 Scraper — Germany's #1 property portal for full apartments
• Willhaben Scraper — Austrian property and classifieds for DACH-region coverage

FAQ

Why use this actor instead of the official WG-Gesucht API?

WG-Gesucht.de does not offer a public API for listing data. Researcher access is limited to manual browsing and the site's internal (unstable, undocumented) endpoints. This actor provides a stable alternative: it reads the same public pages a human sees and returns clean structured JSON — a de facto WG-Gesucht API alternative for rental data.

Is scraping WG-Gesucht.de legal?

The actor accesses only publicly available pages, with no login bypass, no CAPTCHA solving and no access to non-public data. You are responsible for complying with WG-Gesucht's Terms of Service and applicable data-protection law (GDPR for personal data) in your use of the extracted data. See the disclaimer below.

What do Kaltmiete and Warmmiete mean in the data?

WG-Gesucht lists a base rent (Kaltmiete) and in some listings a warm rent (Warmmiete) that includes heating and utilities. The rent field is the base rent as displayed; the full mode costs block separates utilities, other costs, deposit and buyout — exactly what a tenant pays on top.

How much does a WG-Zimmer cost in Berlin or München?

According to the Moses Mendelssohn Institute Mietspiegel 2026 (via Studis Online), average warm WG rents are about 650 € in Berlin and 800 € in München. Actual asking rents vary strongly by district — running this actor on city URLs gives you the real, current distribution instead of averages.

How can I monitor WG-Zimmer rents over time?

Run the actor on the same city search URL weekly (scheduled runs), store the outputs in a dataset, and compare rent by district. The actor parses German number formats, so the rent fields are directly usable in calculations.

Which German cities are supported?

Every city WG-Gesucht hosts — the actor works with any wg-zimmer-in-<City>.<cityId>.0.1.0.html search URL. Verified IDs include Berlin 8, München 90, Hamburg 55, Köln 73, Frankfurt am Main 41, Halle (Saale) 54.

Can I get contact data from WG-Gesucht listings?

Yes — set detailLevel: "full". Each listing page returns the advertiser's public name and, where published, telephone and mobile number. Note that this is personal data: comply with GDPR and do not use it for unsolicited outreach.

Can this actor extract 1-Zimmer-Wohnungen (studios) too?

Yes. Pass a 1-zimmer-wohnungen-in-<City>.<cityId>.1.1.0.html URL (e.g. Münster 91) and the same extraction pipeline returns studio apartment listings.

What are the best German flatshare marketplaces?

WG-Gesucht.de is the largest dedicated German flatshare marketplace. Alternatives include ImmoScout24, Immowelt and Kleinanzeigen — all covered by related Apify actors for cross-portal comparison.

How fast is the actor?

A basic run over one city page completes in ~3-5 seconds. Full-detail mode takes longer because every listing page is fetched individually — budget roughly one request per listing in that mode.

Do I need Apify proxy credentials?

No. The actor uses the Apify proxy with automatic rotation and retries by default (useApifyProxy: true). It works out of the box on all Apify plans.

How often should I run the actor?

Weekly for rent/market monitoring, daily if you want new-listing alerts. Because the actor is pay-per-result only (no charges for empty runs beyond the tiny start fee), frequent small runs stay cheap.

SEO Keywords

wg gesucht scraper, wg zimmer berlin, wg zimmer münchen, wg zimmer hamburg, wg zimmer köln, wg zimmer frankfurt, flatshare germany data, german housing market data, wg gesucht api alternative, rental price monitoring germany, student accommodation daten, wg zimmer preise, mietspiegel daten, 1-zimmer-wohnung münster, german rental data, wg gesucht datenbank, wg zimmer finden, wg preisvergleich städte, deutschland wg marktdaten, wg zimmer verfügbarkeit, zwischenmiete daten, wg gesucht kontakt daten, mietpreise deutsche städte, wohngemeinschaft daten export

For AI Agents & LLM Apps

Purpose: Returns structured WG-Gesucht.de flatshare listings (rent, size, district, availability, contact) plus optional full detail-page data (costs, photos, phone) for German housing market analysis.

Minimal working input:

{
  "startUrls": [
    { "url": "https://www.wg-gesucht.de/wg-zimmer-in-Berlin.8.0.1.0.html" }
  ],
  "maxItems": 10,
  "detailLevel": "basic"
}

Variant inputs: city search + detailLevel: "full" to fetch cost breakdowns, photos and phone contacts from each listing page; or a 1-zimmer-wohnungen-in-<City>.<cityId>.1.1.0.html URL for studio apartments.

Output fields (basic): listingId, title, url, rent (number), size (m² number), availableFrom, wgType, city, district, street, contactName, detailLevel. Full mode adds costs.rent/utilities/otherCosts/deposit/buyout, totalRent, roomSize, apartmentSize, wgTypes, wgDetails, objectDetails, photos[], description, locationDescription, wgLifeDescription, otherDescription, contact.publicName/companyName/telephone/mobile/verifiedUser.

Behaviors an agent should know:

• maxItems caps the number of listings returned — it is a cost guard; leaving it unset defaults to 50 (the input schema default).
• detailLevel defaults to "basic" per the input schema; the implementation falls back to "full" if the field is absent from the input object, which cancels more billed requests — always set it explicitly to control cost.
• German number formats are pre-parsed: "1.234,56 €" → number 1234.56; rent and size are numeric for direct comparison.
• Run costs: $0.0005 per start + $0.002 per basic listing + $0.004 per full listing. Full mode ≈ 2× the result price of basic mode.
• Prefer specific city URLs (verified city IDs: Berlin 8, München 90, Hamburg 55, Köln 73, Frankfurt am Main 41) over site-wide searches for faster, cheaper runs.

Legal & Compliance Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by WG-Gesucht.de (WG-Gesucht GmbH). It accesses only information that is publicly available on wg-gesucht.de pages — it performs no login bypass, no CAPTCHA solving and no access to non-public data.

Users are responsible for complying with WG-Gesucht.de's Terms of Service and applicable data-protection law. Because listings may include personal data (advertiser names and, in full mode, telephone numbers), processing is subject to the GDPR when the data relates to individuals in the EU; personal data returned by this actor should not be used for unsolicited commercial outreach in violation of applicable law.

This README provides factual information about what the actor does; it does not constitute legal advice.