Wohnungsbörse Scraper — Germany Property Data & API 🏠

🎉 Every German rent & sale listing as clean JSON — price, size, rooms, deposit, energy, GPS & photos

For market analysts, real-estate agents, investors and proptech teams who need wohnungsboerse.net data without copy-paste

---

📋 Overview

Pull live German real-estate listings from wohnungsboerse.net into a clean, structured dataset — built for analysts, agents, investors and developers who need property data at scale, not screenshots.

Why professionals choose this scraper:

• ✅ Whole-of-Germany coverage: rent (Miete) and sale (Kauf) listings in any city — Berlin, München, Frankfurt, Hamburg, Köln and beyond
• ⚡ Two speeds: a fast, cheap overview scrape for sizing a market, or full detail pages when you need everything
• 🎯 38 structured fields: price, price per m², area, rooms, deposit, extra costs, energy class, GPS, district, photos and more
• 💰 Pay per result: only charged for the listings you actually get — transparent, no subscription
• 💎 No account, no API key: paste a city or a search URL and run
• ✨ Bonus KPIs: automatic price-per-m² and thumbnail-first rows, ready for analysis

---

✨ Features

• 🏙️ Search by city: give one or more German city names and a contract type
• 🔗 Search by URL: paste any wohnungsboerse.net search URL — every filter you set is preserved
• 🆔 Fetch by listing: pass specific listing URLs or IDs for targeted detail extraction
• 📋 Overview mode: high-volume, low-cost card harvesting from the result list
• 🔎 Detail mode: deposit, Nebenkosten, energy info, floor, construction year, full description and every photo
• 📐 Computed metrics: price-per-m² added automatically to every row
• 🌐 Geo data: latitude/longitude for mapping and territory analysis
• 📤 Export anywhere: JSON, CSV, Excel straight from the Apify dataset

---

🎬 Quick Start

Pick a scrape mode, give it a city (or a search URL), and run. Results land in the dataset as structured rows you can export or pipe into your stack.

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~wohnungsboerse-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","searchMode":"byCity","cities":["Frankfurt"],"contract":"rent","maxResults":50}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose your data depth

Pick overview (fast card list) or detail (full listing pages).

Step 2: Tell it what to scrape

Enter one or more cities + a contract (rent/sale), or paste a search URL.

Step 3: Run and export

Start the actor and download the dataset as JSON, CSV or Excel.

That's it! In a couple of minutes, you'll have:

• A clean table of German property listings
• Prices, sizes, rooms, deposits, energy and GPS
• Direct links and photos for every listing

---

📥 Input Configuration

Field	Type	Required	Description
scrapeMode	string	No	overview (card list) or detail (full pages)
searchMode	string	No	byCity, bySearchUrl, or byListingUrl
cities	array	No	German city names, e.g. ["Frankfurt"]
contract	string	No	rent (Miete) or sale (Kauf)
estateType	string	No	1 = apartment (Wohnung), 2 = house (Haus)
searchUrls	array	No	wohnungsboerse.net search URLs to scrape
listingUrls	array	No	Specific listing URLs or IDs (detail mode)
maxResults	integer	No	Max listings per run
commissionFree	boolean	No	Only commission-free listings
privateOnly	boolean	No	Only private sellers (no agents)
sort	string	No	estates.rent_cold (price) or estates.size (area)
direction	string	No	ASC or DESC

Example — by city:

{
  "scrapeMode": "overview",
  "searchMode": "byCity",
  "cities": ["Berlin", "München"],
  "contract": "rent",
  "maxResults": 100
}

Example — by search URL:

{
  "scrapeMode": "detail",
  "searchMode": "bySearchUrl",
  "searchUrls": ["https://www.wohnungsboerse.net/searches/index?marketing_type=miete&estate_types[0]=1&cities[0]=Frankfurt"]
}

---

📤 Output

Results are saved to the Apify dataset with 38+ fields including:

Field	Type	Description
id	string	wohnungsboerse listing id
url	string	Listing detail page URL
propertyTitle	string	Listing headline
contract	string	rent or sale
property_type	string	Apartment / Wohnung / Haus
price	integer	Kaltmiete (rent) or Kaufpreis (sale), EUR
price_per_sqm_eur	integer	Computed price per m²
area_sqm	number	Living area in m²
rooms	number	Number of rooms
deposit	integer	Kaution (deposit)
extra_costs	integer	Nebenkosten
city / district / zip	string	Location
latitude / longitude	number	GPS coordinates
energy_class	string	Energy efficiency class
images	array	All photo URLs

Example:

{
  "id": "40066766",
  "url": "https://www.wohnungsboerse.net/immodetail/40066766",
  "propertyTitle": "Modernes Apartment nahe Campus Westend",
  "contract": "rent",
  "property_type": "Apartment",
  "price": 245,
  "currency": "EUR",
  "price_per_sqm_eur": 13,
  "area_sqm": 19,
  "rooms": 1,
  "deposit": 750,
  "city": "Frankfurt",
  "district": "Nordend-West",
  "zip": "60322",
  "latitude": 50.1321397,
  "longitude": 8.6783627,
  "construction_year": 2024,
  "is_private": true,
  "image_count": 9
}

---

💼 Use Cases & Examples

1. Rental Market Analysis

Analysts tracking rent levels and supply across German cities.

Input: Several cities + contract: rent Output: Prices, price-per-m², area and district for every listing Use: Build rent indices, spot under- and over-priced submarkets.

2. Real-Estate Lead Generation

Agents sourcing private (no-agent) listings to win mandates.

Input: privateOnly: true + target cities Output: Private listings with location and contact context Use: Prioritize fresh owner-listed properties.

3. Investment Sourcing

Investors screening for yield by price-per-m².

Input: contract: sale, sort by price Output: Sale listings with computed €/m² and size Use: Filter to undervalued opportunities fast.

4. Relocation & Tenant Search

Teams helping employees relocate to a new German city.

Input: City + room/area filters via search URL Output: Matching apartments with photos and GPS Use: Shortlist homes before viewings.

5. Proptech Data Feeds

Developers powering an app or model with live listing data.

Input: Scheduled runs per city Output: Structured JSON ready for a database or pipeline Use: Keep an always-fresh German listings feed.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/wohnungsboerse-property-scraper').call({
  scrapeMode: 'overview',
  searchMode: 'byCity',
  cities: ['Frankfurt'],
  contract: 'rent',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/wohnungsboerse-property-scraper').call(
    run_input={'scrapeMode': 'overview', 'searchMode': 'byCity', 'cities': ['Frankfurt'], 'contract': 'rent'}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~wohnungsboerse-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"scrapeMode":"overview","searchMode":"byCity","cities":["Frankfurt"],"contract":"rent"}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON results
4. Action: Save to a sheet, CRM or database

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• 25 listings per run — full feature access, same quality
• No credit card required
• Perfect for testing and small projects

PAID Tier (Production Ready)

• Unlimited listings per run
• Faster, uninterrupted runs
• Pay-per-result: only charged for listings actually extracted

💰 Pay-per-result pricing — the cheap overview event drives high-volume runs; detail is priced for full-page enrichment.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: How many listings can I scrape? A: FREE tier: 25 per run. PAID tier: unlimited.

Q: Can I scrape by my own filters? A: Yes — set filters on wohnungsboerse.net, copy the search URL, and use bySearchUrl.

Q: What's the difference between overview and detail? A: Overview is the fast, cheap card list. Detail opens each listing for deposit, energy, GPS, description and all photos.

Q: What output formats are available? A: JSON, CSV and Excel — export directly from the Apify dataset.

Q: Do I need a wohnungsboerse.net account or API key? A: No. Just provide a city or a search URL.

Q: Is this legal? A: We only extract publicly available listing data. See the legal section below.

---

🐞 Troubleshooting

No results returned

• Check the city spelling (German names, e.g. München, Köln)
• Confirm the contract matches what the city has (rent vs sale)

Fewer results than expected on FREE tier

• The FREE tier caps at 25 listings per run — upgrade for unlimited

A search URL returns nothing

• Make sure it's a wohnungsboerse.net URL and still valid on the site

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

Trademark notice: "Wohnungsbörse" and wohnungsboerse.net are trademarks of their respective owner. This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by wohnungsboerse.net or ImmobilienScout24. It accesses only publicly available data.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check the SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools