wg-gesucht.de APIwg-gesucht.de ↗
Access shared rooms and apartment listings from WG-Gesucht.de. Filter by location, rent, size, and availability. Returns rent, district, contact name, and more.
curl -X GET 'https://api.parse.bot/scraper/9c7e8891-2311-48ef-84cc-c3e4af8db46b/search_listings?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for shared rooms and apartments on WG-Gesucht.de. Returns listings with details such as rent, room size, district, availability date, and contact information. Results can span WG rooms, 1-room apartments, and larger apartment categories.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of listings to return. |
{
"type": "object",
"fields": {
"total": "integer total number of listings returned",
"listings": "array of listing objects with title, url, rent_per_month, size_sqm, district, availability_date, contact_name, is_women_only, and is_unlimited fields"
},
"sample": {
"data": {
"total": 5,
"listings": [
{
"url": "https://www.wg-gesucht.de/wg-zimmer-in-Berlin-Mitte.13453035.html",
"title": "Furnished 16 m2 room in central Mitte, Anmeldung possible, balcony, 2 bathrooms",
"district": "Mitte",
"size_sqm": 16,
"contact_name": "Contact via site",
"is_unlimited": false,
"is_women_only": false,
"rent_per_month": 750,
"availability_date": "15.05.2026"
}
]
},
"status": "success"
}
}About the wg-gesucht.de API
The WG-Gesucht.de API provides access to German rental listings through a single search_listings endpoint that returns up to the requested number of listings, each carrying 8 structured fields including rent, room size, district, availability date, and contact name. It covers WG shared rooms, 1-room apartments, and larger apartment categories, making it practical for building rental trackers, relocation tools, or housing market dashboards targeting the German market.
What the API Returns
The search_listings endpoint queries WG-Gesucht.de and returns a total count alongside a listings array. Each listing object includes title, url, rent_per_month, size_sqm, district, availability_date, contact_name, and an is_women_only boolean flag. This gives you enough detail to filter, rank, or display listings without any additional lookup.
Filtering and Scope
The limit parameter controls how many listing objects are returned in a single call. The results span all three main WG-Gesucht listing categories: shared room offers (WG-Zimmer), 1-room apartments, and multi-room apartments. The district field reflects the sub-city area listed on the posting, which is useful for neighborhood-level filtering in German cities like Berlin, Munich, Hamburg, and Cologne.
Notable Data Points
The is_women_only flag directly reflects the listing's stated tenant preference, which is a common filter criterion on WG-Gesucht. The availability_date field indicates when the room or apartment is free from, allowing date-range logic on the client side. The contact_name field returns the name as listed by the poster, which may be an individual or an agency name.
- Build a rental alert tool that notifies users when new listings appear in a specific district below a target rent_per_month.
- Aggregate WG-Gesucht listings into a relocation dashboard for companies onboarding employees to German cities.
- Filter listings by is_women_only to surface women-only housing options in a dedicated search interface.
- Track average rent_per_month and size_sqm over time by district to analyze rental market trends in German cities.
- Cross-reference availability_date with user move-in windows to shortlist time-compatible listings.
- Populate a student housing finder that queries shared rooms within a size and price range near university districts.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does WG-Gesucht.de have an official developer API?+
What does the search_listings endpoint distinguish between listing types?+
title and url fields typically identify the listing type, but there is no dedicated listing_type field in the current response schema to filter programmatically by category.Can I filter results by city, price range, or room size in the API call?+
limit, which sets the maximum number of listings returned. Client-side filtering on rent_per_month, size_sqm, or district from the response is required for narrowing results. You can fork this API on Parse and revise it to add server-side filter parameters for city, price range, or room size.Does the API return listing photos or full description text?+
url field links to the full listing page. You can fork the API on Parse and revise it to add an endpoint that fetches additional listing detail fields such as description text or image URLs.How fresh are the listings returned by the API?+
posted_date or last_updated field in the response. Listings that have been filled but not yet removed by the poster may still appear in results.