Immowelt API: Immobilienanzeigen als JSON
Immowelt bietet Entwicklern keinen offenen Zugang; die Schnittstellen dort richten sich an Makler mit Vertrag. Was hier zurückkommt, ist das öffentlich sichtbare Angebot — Kaufpreis oder Miete, Fläche, Zimmer, Lage — als JSON. Der Ort ist dabei Pflicht, und das ist Absicht: eine Immobiliensuche ohne Ort beantwortet keine sinnvolle Frage.
Endpunkte
| endpoint | Was zurückkommt | Pflicht |
|---|---|---|
| search | Suche nach Immobilienanzeigen in einer Stadt, einem Stadtteil, einem Postleitzahlgebiet oder einem Bundesland. | location |
| detail | Der vollständige Datensatz einer Anzeige über die Exposé-URL oder die listing id: Preis beziehungsweise Miete, Fläche, Zimmer, Baujahr, Ausstattung und Bilder. | listing |
| location | Löst einen freien Ortsnamen — Stadt, Gemeinde, Stadtteil oder Bundesland — in Immowelts eigene Ortskennung auf. | query |
Jeder Aufruf wird in Credits abgerechnet. Fehlgeschlagene und blockierte Aufrufe sind kostenlos.
Funktionierendes Beispiel
Zuerst den Ort auflösen, dann suchen. Ein frei getippter Ortsname trifft sonst leicht die falsche Ebene: 'Neustadt' gibt es in Deutschland dutzendfach.
curl -X POST https://api.reefapi.com/immowelt/v1/search \
-H "x-api-key: IHR_SCHLUESSEL" \
-H "content-type: application/json" \
-d '{"location": "koeln", "page": 1}'{
"ok": true,
"data": {
"results": [
{
"listing_id": "...",
"title": "...",
"price": 389000,
"currency": "EUR",
"living_area_m2": 78,
"rooms": 3,
"city": "Köln"
}
]
},
"meta": { "record_count": 20, "cache_hit": false, "mode": "live" }
}Statt eines eigenen Immowelt-Scrapers
Ein eigener Scraper für Immowelt läuft am Anfang. Danach kommt das Übliche: ändert sich der Aufbau der Liste, liefert der Parser leer statt einen Fehler zu werfen, und bei längeren Läufen greift der Bot-Schutz.
Bei Immobilien kommt eine zweite Schwierigkeit dazu, die ein eigener Scraper selten sauber löst: Ortsnamen sind mehrdeutig und die Seite arbeitet intern mit eigenen Ortskennungen. Hier ist das Auflösen ein eigener Endpunkt.
Für eine einmalige Marktübersicht ist das eigene Skript billiger. Für eine Beobachtung, die wöchentlich laufen soll, zahlt man für die Ausfälle.
Grenzen und ehrliche Hinweise
- Das ist nicht die offizielle Immowelt-Schnittstelle, und wir haben keine Partnerschaft mit Immowelt.
- `location` ist Pflicht. Eine bundesweite Suche ohne Ort gibt es nicht.
- Angaben wie Baujahr oder Energiekennwert kommen nur, wenn das Exposé sie veröffentlicht; sonst null.
- Kein Cache: jeder Aufruf ist live.