WG-Gesucht Property Details Scraper

Scrapes detailed property listings from WG-Gesucht.de, one of Europe's largest rental platforms, and outputs structured data for analysis.

Overview

This actor automates data extraction from individual WG-Gesucht property listing pages. It's built for real estate analysts, researchers, or developers who need to collect structured data on apartments, shared flats, and rental rooms at scale, bypassing manual copy-pasting.

Key Features

• Structured Data Extraction: Pulls comprehensive details from property pages into a clean, machine-readable format (JSON, CSV, etc.).
• Handles Multiple Property Types: Works with studio apartments, multi-room flats, shared accommodations, and temporary rentals.
• Built for Scale: Processes lists of URLs efficiently, turning what would be days of manual work into minutes.
• Proxy Support: Configurable to use Apify Proxy (including residential proxies) to help avoid bot detection.
• Error Handling: Includes configurable retry logic for failed requests.

How to Use

Configure the actor with an input JSON object, then run it. It will fetch each provided URL, scrape the data, and deliver the results to your dataset.

Input/Output

Input

The actor requires an input JSON object. The main parameters are:

{
  "urls": [
    "https://www.wg-gesucht.de/1-zimmer-wohnungen-in-Aachen-Aachen.12112971.html",
    "https://www.wg-gesucht.de/1-zimmer-wohnungen-in-Tuebingen-Tuebingen.12178737.html"
  ],
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  },
  "max_items_per_url": 20
}

• urls (required): An array of direct URLs to WG-Gesucht property listing pages.
• max_retries_per_url: Number of retry attempts for a URL if a request fails.
• proxy: Configuration for Apify Proxy. Using residential proxies ("RESIDENTIAL") and setting the country to match your target (e.g., "DE" for Germany) is recommended.
• max_items_per_url: A limit for the number of items scraped per URL (useful for search result pages, though this actor is primarily for direct listing URLs).

Output

The actor outputs a dataset where each item represents a scraped property. Each record contains structured fields such as:
* Title, description, and property type.
* Location details (city, district, address).
* Rental price, deposit, and utility costs.
* Property size, number of rooms, and available from date.
* Landlord/agency information and contact details.
* Listing URL and unique identifier.

Data is available in formats like JSON, CSV, XML, and Excel via the Apify platform.

Contact

For issues or questions, contact the developer via My profile.