Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

WG-Gesucht Scraper — German Flatshare & Rentals

Apify Actor Run on Apify No API key Export

Export German flatshare, WG-room and apartment rental listings — no API key, no login, 1,000+ listings per city.

Export German shared-flat and apartment rental listings from WG-Gesucht.de, Germany's #1 portal for a WG room (Wohngemeinschaft / flatshare), a 1-room flat (Wohnung), a whole apartment, a house or a sublet (Zwischenmiete). This WG-Gesucht scraper turns any search into a clean, structured dataset across Berlin, Munich, Hamburg, Cologne, Frankfurt, Leipzig and every German city — with rent in EUR, size in m², room count, city, district, street, and move-in / move-out dates.

Pick a city and property type from the built-in dropdowns, or paste full search URLs copied straight from WG-Gesucht to reuse every filter you set there. No login, no API key, no token. Export the results to JSON, CSV, JSONL, Excel or XML, or pull them via the Apify API into your rental-price model, proptech dashboard or BI tool.


▶️ Run it now

https://apify.com/logiover/wg-gesucht-scraper — open the Actor, click Try for free, pick a city (or paste a search URL), and run it to get hundreds or thousands of structured listings in your dataset.

✨ What you get (output fields)

One flat row per listing, including:

Field Description
id / title / url Listing ID, title and canonical listing URL
listingType WG room / 1-room flat / apartment / house / sublet
propertyType German property type (e.g. 2-Zimmer-Wohnung)
rent / currency Rent amount and currency (EUR)
sizeSqm Size in square metres (m²)
rooms Number of rooms
city / district / street City, neighbourhood and street
availableFrom Move-in date
availableTo Move-out date (for sublets / Zwischenmiete)
posterName / onlineStatus Who posted the ad and how recently they were online
image Thumbnail image URL
sourceUrl The search URL this listing came from
scrapedAt ISO 8601 scrape timestamp

💡 Use cases

  • Rental-price analysis — track rent, €/m² and room counts across Berlin, Munich, Hamburg, Cologne and more.
  • Flatshare & WG market research — map WG-room supply, districts and availability over time.
  • Availability & trend monitoring — schedule daily runs to watch new listings and how fast the market moves.
  • Comps & valuation — feed rooms, size, district and rent into pricing or affordability models.
  • Rental portals & dashboards — power a listings feed or BI dashboard straight from the Apify API.
  • Relocation & HR — build city-by-city rent snapshots for relocation packages and cost-of-living comparisons.
  • Student & expat housing tools — surface WG rooms and 1-room flats by city and budget.

🚀 Quick start (4 ways)

1. Apify Console (no code)

Open the Actor page, click Try for free, choose a City and Property type from the dropdowns (or paste one or more WG-Gesucht search URLs into Search URLs), then press Start. Export from the Output tab.

2. Apify CLI

npm install -g apify-cli
apify login
apify call logiover/wg-gesucht-scraper \
  --input='{ "city": "Berlin", "category": "wg-rooms", "maxResults": 500 }'

3. API / curl (run and get dataset items in one call)

curl -X POST "https://api.apify.com/v2/acts/logiover~wg-gesucht-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "Muenchen",
    "category": "apartments",
    "maxResults": 300
  }'

4. apify-client (JavaScript & Python)

See examples/javascript.md and examples/python.md. More curl recipes are in examples/api-curl.md and CLI recipes in examples/cli.md.

📥 Input

Everything is optional — use the City + Property-type dropdowns, or paste full Search URLs to reuse every filter you set on WG-Gesucht.

Field Type Default Description
searchUrls array [] Full WG-Gesucht search URLs copied from the site (reuses price/district/size filters). Overrides the pickers below.
city string (dropdown) Berlin German city to pull listings for (used only when no Search URLs). 30 cities including München, Hamburg, Köln, Frankfurt, Leipzig, Dresden, Stuttgart, Düsseldorf.
category string (dropdown) apartments Whole apartments, WG rooms / flatshares, 1-room flats, or Houses.
rentType string (dropdown) any Any, Permanent only (unbefristet), or Temporary only (befristet / sublet).
sortBy string (dropdown) newest Newest first, Rent low→high, Rent high→low, Size largest first, or Rooms most first.
maxResults integer 200 Global cap across all searches. 0 = no limit (a single city can span 50+ pages / 1,000+ listings).
maxResultsPerSearch integer 0 Optional per-search cap. 0 = no per-search cap.
maxConcurrency integer 3 How many search URLs to process in parallel (1–10).
proxyConfiguration object Residential Apify Proxy settings. Residential (default) gives the highest success rate on this German site.

Building a search URL: on WG-Gesucht pick a city and category (WG-Zimmer, 1-Zimmer-Wohnung, Wohnung, Haus), apply your filters, then copy the URL from the address bar. Add several URLs to scrape multiple cities and categories in one run.

📤 Output

Results are stored in an Apify dataset — one row per listing — exportable to JSON, CSV, JSONL, Excel or XML. A realistic sample item:

{
  "id": "13507864",
  "title": "Dachgeschosswohnung 58m² zur Zwischenmiete in Kreuzberg 36",
  "url": "https://www.wg-gesucht.de/wohnungen-in-Berlin-Kreuzberg.13507864.html",
  "listingType": "Apartment",
  "propertyType": "2-Zimmer-Wohnung",
  "rent": 1300,
  "currency": "EUR",
  "sizeSqm": 58,
  "rooms": 2,
  "city": "Berlin",
  "district": "Kreuzberg",
  "street": "Manteuffelstr",
  "availableFrom": "05.06.2026",
  "availableTo": null,
  "posterName": "Herr Müller",
  "onlineStatus": "Online: 2 Minuten",
  "image": "https://img.wg-gesucht.de/media/up/.../thumb.jpg",
  "sourceUrl": "https://www.wg-gesucht.de/wohnungen-in-Berlin.8.2.1.0.html",
  "scrapedAt": "2026-07-06T15:31:24.950Z"
}

🔗 Integrations & automation

  • Schedules — run every morning for a fresh WG-Gesucht listings feed.
  • Webhooks — trigger a downstream job or alert the moment new listings arrive.
  • Google Sheets / Amazon S3 / warehouses — push the dataset to a spreadsheet, S3, BigQuery, Snowflake or Postgres.
  • Zapier, Make, n8n, Pipedream — connect through the Apify integration to build automated rental-monitoring pipelines.
  • BI & dashboards — feed rent, size and district straight into Tableau, Power BI or Looker.

📦 Export formats

CSV · JSON · JSONL · Excel (XLSX) · XML — download from the Output tab or via the API (see examples/api-curl.md).

❓ FAQ

Do I need a WG-Gesucht account or API key?

No. The Actor reads publicly available listing data — no login and no token. Only a free Apify account is required.

Is this a WG-Gesucht API alternative?

Effectively yes. WG-Gesucht has no public API, so this Actor works as a WG-Gesucht API alternative, giving you the structured listing data (rent, size, rooms, district, availability) an API would return.

Which property types are supported?

All of them — WG rooms (flatshares), 1-room flats, whole apartments, houses and sublets (Zwischenmiete). Pick the type from the Property type dropdown or paste that category's search URL.

How do I filter by city, price, rooms or move-in date?

Either use the built-in City / Property type / Rental period / Sort order dropdowns, or apply the filters on WG-Gesucht itself and paste the resulting URL into searchUrls — every filter encoded in the URL is respected.

How many listings can I get per city?

A single big-city search (e.g. apartments in Berlin) can span 50+ pages — well over 1,000 listings. Use maxResults to cap the run, or 0 for everything.

How do I scrape WG-room (flatshare) listings in Berlin?

Set City to Berlin and Property type to WG rooms / flatshares (or paste a WG-Zimmer Berlin search URL). The Actor paginates every flatshare room with rent, size and district.

Can I scrape multiple German cities in one run?

Yes. Add several search URLs for different cities and categories (e.g. Berlin apartments and Munich WG rooms) and they are all collected into one dataset.

How do I export WG-Gesucht data to CSV or Excel?

Run the Actor, open the Output tab, and choose CSV, JSON, JSONL, Excel or XML — or pull the dataset via the Apify API. See examples/api-curl.md.

Is it free to try?

You can run it on the Apify free tier before scaling up. Pricing is pay-per-result — see the Pricing tab on the Actor page.

Is it legal to scrape WG-Gesucht?

The Actor collects only publicly available listing data. You are responsible for complying with WG-Gesucht's terms of service, the GDPR and applicable local laws — including how you use any personal data in the listings.

🔎 Related actors

Browse the full European real-estate suite at apify.com/logiover — 180+ actors across real estate, jobs, crypto, social media and B2B data.


📄 Documentation only — this repository contains no source code. The Actor runs on the Apify platform. ▶️ Run it: https://apify.com/logiover/wg-gesucht-scraper

Released under the MIT License · © 2026 logiover

About

WG-Gesucht scraper — German flatshares, WG-rooms, apartments & sublets with rent, m², rooms & district. No API key.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors