Eine GraphQL-API für Deutschlands Immobilienportale: Somantic vorgestellt

Der deutsche Immobilienmarkt erzielte 2025 ein Transaktionsvolumen von rund 284,4 Milliarden Euro, ein Plus von 17,5 % gegenüber dem Vorjahr, laut IVD. Wer die richtige Immobilie in diesem Markt sucht, muss jedoch eine ganze Reihe von Portalen durchforsten: ImmobilienScout24, Immowelt, Immonet, Kleinanzeigen, Ohne Makler und weitere. Jedes Portal führt Angebote, die die anderen nicht haben. Jedes hat eine andere Suchoberfläche. Und wer zu lange wartet, hat das Inserat verpasst: Mietwohnungen in Deutschland sind nach Angaben einer IfW-Kiel-Studie vom Juli 2025 im Schnitt bereits nach 23 Tagen vermietet.

Somantic löst dieses Problem. Die Plattform ist eine deutsche Immobiliendaten-Plattform, die Angebote aus allen großen deutschen Portalen in einer einzigen Suchoberfläche und einem einzigen GraphQL-Endpunkt zusammenfasst. Dazu gibt es eine transparente Immobilienbewertungs-API, die genau zeigt, welche Vergleichsobjekte den Schätzwert ergeben haben, ganz ohne Black-Box-Bewertung.

Ein Markt, der schneller ist als die meisten Suchanfragen

Deutschland befindet sich mitten in einer Wohnraumkrise. Die Bundesregierung hatte 400.000 neue Wohnungen pro Jahr als Ziel ausgegeben. Im Jahr 2025 wurden laut Destatis-Daten vom Mai 2026 nur 206.600 fertiggestellt, der niedrigste Stand seit 2012. Der Rat der Immobilienweisen beziffert das aktuelle Defizit auf rund 600.000 Wohnungen, mit einer Prognose von 830.000 bis 2027.

Wenn das Angebot knapp ist, verschärft sich der Wettbewerb. In Berlin verschwindet jedes vierte Mietangebot bereits innerhalb von 2 Tagen nach der Einstellung (IfW Kiel, 2025). ImmobilienScout24 verzeichnete allein im ersten Quartal 2024 einen Anstieg der Kaufanfragen um 47 % in den acht größten deutschen Städten. Und die Kaufpreise in den Metropolen sprechen für sich. Laut JLLs Wohnimmobilienüberblick für das zweite Halbjahr 2025:

• München: 8.667 Euro pro m² für Bestandswohnungen
• Frankfurt: 6.217 Euro pro m² (plus 3,5 % im Jahresvergleich)
• Hamburg: 6.201 Euro pro m²
• Berlin: 5.647 Euro pro m², Angebotsmieten stiegen um 12 % im Jahresvergleich (Berlin Hyp / CBRE, Mai 2025)

Bei diesen Preisen und diesem Tempo ist das Verpassen eines Angebots, weil man nur ein oder zwei Portale durchsucht hat, ein teurer Fehler.

Was ist Somantic?

Somantic ist eine Immobiliendaten-Plattform, die speziell für den deutschen Markt entwickelt wurde. Sie bezieht kontinuierlich Angebote aus allen unterstützten deutschen Portalen und stellt diese über eine einheitliche Web-Oberfläche und eine GraphQL-API bereit. Auf Basis der Rohdaten läuft außerdem ein KI-gestützter Immobilienberater, der Nutzerinnen und Nutzern hilft, Angebote zu analysieren, Marktpreise einzuschätzen und personalisierte Empfehlungen zu erhalten.

Derzeit aktive Portale im Feed:

Weitere Portale, darunter Meinstadt.de, Wohnung Jetzt und Sparkasse Immobilien, werden derzeit integriert.

Deutsche Immobilien mit einem GraphQL-Aufruf abfragen

Die Somantic-GraphQL-API hat zwei Zugangspunkte. Das Entwicklerportal unter somantic.net/developers bietet direkten Zugang mit einer integrierten Web-Oberfläche und vollständiger Dokumentation, unabhängig von einer Drittanbieterplattform. Die API ist außerdem auf RapidAPI gelistet für Teams, die RapidAPIs Authentifizierung und Abrechnung bevorzugen. Beide Endpunkte unterstützen dasselbe Abfrageschema für Wohnungen und Häuser, mit Filterung nach Bundesland, Stadt, Postleitzahl, Aktion (kaufen oder mieten) und Portal.

Die GraphQL-Umfrage von Hygraph 2024 ergab, dass 61,7 % der Entwicklerinnen und Entwickler GraphQL bereits produktiv einsetzen und 89 % der Anwender die Technologie erneut wählen würden. Für Immobiliendaten ist GraphQL besonders geeignet: Man fragt exakt die benötigten Felder ab, kombiniert mehrere Filterdimensionen in einer Anfrage und paginiert sauber ohne Over-Fetching.

1. Kaufwohnungen in Bayern abfragen (nur Kleinanzeigen)

Um die 10 zuletzt eingestellten aktiven Kaufwohnungen in Bayern von Kleinanzeigen abzurufen, mit Filterung nach Portal und Bundesland:

query AppartmentQuery {
  all_appartments(
    order_by: "-uptime_date"
    per_page: 10
    page: 1
    filters: {
      is_active: true
      action: "kaufen"
      location: "bl-bayern"
      spider: "kleinanzeigen"
    }
  ) {
    edges {
      node {
        uptime_date
        url
        square_meter
        price
      }
    }
  }
}

Um die nächste Seite aufzurufen, erhöhen Sie den Parameter page auf 2. Das Maximum pro Seite beträgt 100 Ergebnisse.

2. Kaufhäuser in Baden-Württemberg, nach Preis sortiert

query HouseQuery {
  all_houses(
    order_by: "-price"
    per_page: 20
    page: 1
    filters: {
      is_active: true
      action: "kaufen"
      location: "bl-baden-wuerttemberg"
      spider: "immowelt"
    }
  ) {
    edges {
      node {
        uptime_date
        url
        square_meter
        price
      }
    }
  }
}

3. Mietwohnungen nach Stadt abfragen

Um innerhalb einer bestimmten Stadt statt eines ganzen Bundeslandes zu suchen, verwenden Sie den Filter city. Dieses Beispiel ruft die 100 aktuellsten Mietangebote in Hagen aus allen Portalen ab:

query ActiveRentApartmentHagenQuery {
  all_appartments(
    order_by: "-uptime_date"
    per_page: 100
    page: 1
    filters: { is_active: true, city: "Hagen", action: "mieten" }
  ) {
    edges {
      node {
        immo_id
        url
        spider
        title
        location
        city
        zipcode
        rent_price
        warm_rent_price
        extra_charges_price
        rent_per_square_meter
        square_meter
        year_of_construction
        uptime_date
      }
    }
  }
}

4. Nach Postleitzahl filtern

Für Käufer, die bereits ein bestimmtes Viertel im Blick haben, eignet sich der Filter zipcode_in. Dieses Beispiel findet alle aktiven Kaufangebote im Postleitzahlengebiet 23552 von Lübeck:

query ActiveBuyApartment23552Query {
  all_appartments(
    order_by: "-uptime_date"
    per_page: 100
    page: 1
    filters: { is_active: true, zipcode_in: 23552, action: "kaufen" }
  ) {
    edges {
      node {
        immo_id
        url
        spider
        title
        city
        state
        zipcode
        price
        price_per_square_meter
        square_meter
        year_of_construction
        uptime_date
      }
    }
  }
}

Marktanalyse mit Aggregationsabfragen

Über einzelne Angebote hinaus unterstützt Somantic Aggregationsabfragen, die für Investoren und Marktforscher wertvoll sind. Sie können Durchschnittspreise pro Quadratmeter, Durchschnittsmieten und die Gesamtzahl aktiver Angebote für jedes Bundesland, jede Stadt oder Filterkombination abrufen.

Durchschnittlicher Kaufpreis pro m² in Baden-Württemberg

query ActiveApartmentAveragePriceBWQuery {
  avg_appartments(
    filters: { is_active: true, action: "kaufen", location: "bl-baden-wuerttemberg" }
  ) {
    edges {
      node {
        avg_price_per_square_meter
      }
    }
  }
}

Durchschnittliche Miete pro m² in Hamburg

query ActiveApartmentAverageRentHHQuery {
  avg_appartments(
    filters: { is_active: true, action: "mieten", location: "hamburg" }
  ) {
    edges {
      node {
        avg_rent_per_square_meter
      }
    }
  }
}

Gesamtanzahl aktiver Mietangebote in Hamburg

query ActiveRentApartmentCountHHQuery {
  total_appartments_count(
    filters: { is_active: true, action: "mieten", location: "hamburg" }
  )
}

Diese Aggregationsabfragen geben Investoren einen Live-Marktüberblick, ohne Tausende von Einzeldatensätzen herunterladen, speichern und verarbeiten zu müssen. Sie eignen sich besonders gut, um Preisentwicklungen über Bundesländer hinweg zu beobachten oder Mietrenditen zwischen Städten zu vergleichen.

Transparente Immobilienbewertung für Deutschland

Immobilienbewertungen in Deutschland waren bisher oft undurchsichtig: Ein Algorithmus liefert eine Zahl, ohne zu verraten, ob sie auf 5 oder 500 aktuellen Verkäufen basiert. Die Property Valuation Germany API funktioniert anders. Sie berechnet den Schätzwert aus dem Durchschnitt ähnlicher aktiver Angebote in der gleichen Region und gibt jedes Vergleichsobjekt zurück, sodass Sie genau nachvollziehen können, wie der Wert entstanden ist.

Hier ist ein Beispiel, das eine 100,5 m² große Wohnung mit 2,5 Zimmern aus dem Baujahr 1990 in München bewertet:

import requests

url = "https://property-valuation-germany.p.rapidapi.com/api/estimate"

payload = {
    "street": "Admiralsbogen 45",
    "postcode": 80939,
    "square_meters": 100.5,
    "rooms": 2.5,
    "year_of_construction": 1990,
    "typ": "wohnung",  # Use "haus" for a house
    "city": "Muenchen"
}
headers = {
    "x-rapidapi-key": "YOUR_RAPID_API_KEY",
    "x-rapidapi-host": "property-valuation-germany.p.rapidapi.com",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Die Antwort enthält einen price-Schätzwert, einen rent-Schätzwert und ein similar_properties-Array mit allen Vergleichsobjekten, die in die Berechnung eingeflossen sind. Jedes Vergleichsobjekt umfasst das Quellportal, den aktuellen Aktivierungsstatus, den Kauf- oder Mietpreis pro Quadratmeter, die Zimmeranzahl, das Baujahr und einen direkten Link zum Originalinserat. Für eine Beispielimmobilie in München-Schwabing könnte die API einen Kaufwert von rund 800.000 Euro und eine monatliche Miete von 2.400 Euro zurückgeben, gestützt auf 20 oder mehr aktive Vergleichsobjekte von ImmobilienScout24, Immowelt und Immonet.

Das ist besonders wichtig für Käufer, die in einem wettbewerbsintensiven Markt Angebote abgeben, und für Investoren, die ihre Bewertungsannahmen gegenüber Partnern oder Kreditgebern begründen müssen. München fertigstellte 2024 nur 6.503 neue Wohnungen, ein Rückgang von 34 % gegenüber 2023 (JLL Stadtprofil München, 2025). In einem angebotsknappen Markt ist es wertvoller zu wissen, zu welchen Preisen vergleichbare Objekte tatsächlich gehandelt werden, als sich auf einen generischen Algorithmus zu verlassen.

Für wen ist Somantic gemacht?

Immobilienkäufer und Mieter

Die Web-Oberfläche auf somantic.net bietet auch nicht-technischen Nutzerinnen und Nutzern die Vorteile der portalübergreifenden Zusammenführung, ohne eine Zeile Code schreiben zu müssen. Suchen Sie gleichzeitig in allen abgedeckten Portalen nach Wohnungen oder Häusern, nutzen Sie erweiterte Filter und setzen Sie den KI-gestützten Berater ein, um Angebote zu vergleichen und Preise einzuschätzen.

Immobilieninvestoren

Investoren, die mehrere Regionen beobachten, profitieren von den Aggregationsabfragen. Rufen Sie Durchschnittspreistrends pro Quadratmeter für ein Bundesland im Zeitverlauf ab, vergleichen Sie Mietrenditen zwischen Hamburg und Frankfurt oder verfolgen Sie die Gesamtzahl aktiver Angebote als Näherungswert für den Angebotsdruck. Das BBSR prognostiziert, dass Deutschland bis 2030 jährlich 320.000 neue Wohnungen benötigt. Die Lücke zwischen Angebot und Nachfrage wird sich nicht schnell schließen, was datengestützte Investitionsentscheidungen immer wertvoller macht.

PropTech-Entwickler

Der europäische PropTech-Markt wurde 2024 auf 10,79 Milliarden US-Dollar geschätzt und soll bis 2033 auf 50,70 Milliarden US-Dollar wachsen (Market Data Forecast). Entwicklerinnen und Entwickler, die Immobilien-Tools, Marktanalyse-Dashboards, Investitionsplattformen oder käuferorientierte Produkte für Deutschland bauen, benötigen verlässliche Daten aus mehreren Quellen. Somantic liefert genau das über eine standardisierte GraphQL-Schnittstelle auf RapidAPI, ohne dass eigene Scrapers für jedes Portal separat aufgebaut und gepflegt werden müssen.

---

Häufig gestellte Fragen

Was ist Somantic?

Somantic ist eine deutsche Immobiliendaten-Plattform, die Angebote von ImmobilienScout24, Immowelt, Immonet, Kleinanzeigen, Ohne Makler und weiteren deutschen Portalen in einer einzigen Oberfläche und einer einzigen GraphQL-API zusammenfasst. Außerdem bietet sie einen KI-gestützten Immobilienberater und eine transparente Bewertungs-API, die Vergleichsobjekte statt einer Black-Box-Schätzung liefert.

Welche Portale deckt Somantic ab?

Somantic deckt derzeit ImmobilienScout24, Immowelt, Immonet, Kleinanzeigen, Ohne Makler, Private-Immobilienangebote, Immobilien.de, FAZ Immobilienmarkt, OVBImmo, SWP Immo und VRM-Immo ab. Weitere Portale, darunter Meinstadt.de und Sparkasse Immobilien, sind in Vorbereitung.

Wie kann ich auf die Somantic-GraphQL-API zugreifen?

Der einfachste Einstieg ist das Entwicklerportal unter somantic.net/developers, das eine Web-Oberfläche für interaktive Abfragen und vollständige API-Dokumentation enthält. Dieser Endpunkt ist direkt und unabhängig von jeder Drittanbieterplattform. Die API ist auch auf RapidAPI (somantic-net) gelistet für Teams, die bereits RapidAPIs Infrastruktur nutzen.

Wie funktioniert die Somantic-Immobilienbewertungs-API?

Die Property Valuation Germany API nimmt Adresse, Postleitzahl, Quadratmeter, Zimmeranzahl, Baujahr, Typ (Wohnung oder Haus) und Stadt entgegen. Sie gibt einen Kaufwertschätzwert und einen Mietschätzwert zurück, basierend auf dem Durchschnitt vergleichbarer aktiver Angebote in derselben Region. Jedes Vergleichsobjekt wird gemeinsam mit dem Schätzwert zurückgegeben, sodass die Bewertung vollständig transparent ist.

Kann ich Angebote nach Stadt, Bundesland oder Postleitzahl filtern?

Ja. Die API unterstützt die Filterung nach Stadt, Bundesland (im Somantic-Location-Slug-Format, z. B. bl-bayern für Bayern), Postleitzahl, Aktion (kaufen oder mieten) und Portal. Mehrere Filter können in einer einzigen Abfrage kombiniert werden. Ergebnisse werden auf maximal 100 pro Seite paginiert.

---