One GraphQL API for Germany's Real Estate Portals: Introducing Somantic

The German real estate market transacted roughly €284.4 billion in 2025, up 17.5% year-on-year according to IVD. But finding the right property inside that market means checking a list of portals: ImmobilienScout24, Immowelt, Immonet, Kleinanzeigen, Ohne Makler, and several more. Each portal carries listings that the others do not. Each has a different search interface. And if you wait too long, the listing is gone: apartments across Germany are rented within 23 days of appearing online on average, according to IfW Kiel research from July 2025.

Somantic solves this. It is a German real estate intelligence platform that aggregates listings from all the major German portals into a single search interface and a single GraphQL endpoint. It also ships a transparent property valuation API that shows you exactly which comparable properties drove the estimate, with no black-box pricing.

A market moving faster than most buyers can search

Germany is in the middle of a housing supply crisis. The federal government set a target of 400,000 new homes per year. In 2025 only 206,600 were completed, the lowest since 2012 according to Destatis data reported in May 2026. The Rat der Immobilienweisen (Council of Real Estate Experts) puts the current shortage at around 600,000 units, projected to reach 830,000 by 2027.

When supply is constrained, competition accelerates. In Berlin 1 in 4 rental listings disappears within 2 days of posting (IfW Kiel, 2025). ImmobilienScout24 recorded a 47% increase in purchase inquiry contacts across Germany's top 8 cities in Q1 2024 alone. And purchase prices in the major metros tell their own story. According to JLL's Housing Market Overview for H2 2025:

• Munich: €8,667 per sqm for existing apartments
• Frankfurt: €6,217 per sqm (up 3.5% year-on-year)
• Hamburg: €6,201 per sqm
• Berlin: €5,647 per sqm, with asking rents up 12% year-on-year (Berlin Hyp / CBRE, May 2025)

At these prices and at this pace, missing a listing because you were only checking one or two portals is an expensive mistake.

What is Somantic?

Somantic is a real estate intelligence platform built specifically for the German market. It pulls listings continuously from all supported German portals and exposes them through a unified web interface and a GraphQL API. On top of the raw listing data it runs an AI-powered property advisor that helps users analyze offers, assess market pricing, and receive personalized recommendations.

Portals currently active in the feed:

Additional portals, including Meinstadt.de, Wohnung Jetzt, and Sparkasse Immobilien, are currently being integrated.

Query German listings with one GraphQL call

The Somantic GraphQL API has two access points. The developer portal at somantic.net/developers gives direct access with a built-in web UI and full documentation, independent of any third-party platform. It is also listed on RapidAPI for teams that prefer RapidAPI's authentication and billing. Both endpoints support the same query schema for apartments and houses, with filtering by state, city, zip code, action (buy or rent), and portal.

Hygraph's 2024 GraphQL survey found that 61.7% of developers already use GraphQL in production and 89% who adopted it would choose it again. For real estate data, GraphQL makes particular sense: you ask for exactly the fields you need, combine multiple filter dimensions in one request, and paginate cleanly without over-fetching.

1. Query apartments for sale in Bavaria (Kleinanzeigen only)

To retrieve the 10 most recently listed active apartments for sale in Bavaria from Kleinanzeigen, filtering on both portal and state:

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
      }
    }
  }
}

To view the next page, increment the page parameter to 2. The maximum results per page is 100.

2. Query houses for sale in Baden-Wuerttemberg ordered by price

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. Query apartments for rent by city

If you want to search within a specific city rather than an entire state, use the city filter. This example pulls the 100 most recent rental listings in Hagen across all portals:

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. Filter by zip code

For buyers who already have a specific neighborhood in mind, the zipcode_in filter makes it easy. This example finds all active purchase listings in the 23552 zip code area of Luebeck:

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
      }
    }
  }
}

Market analysis with aggregate queries

Beyond individual listings, Somantic supports aggregate queries useful for investors and market researchers. You can retrieve average prices per square meter, average rents, and total active listing counts across any state, city, or combination of filters.

Average purchase price per sqm in Baden-Wuerttemberg

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

Average rent per sqm in Hamburg

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

Total rental listing count in Hamburg

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

These aggregate queries give investors a live market pulse without having to download, store, and process thousands of individual records. They are particularly useful for monitoring price movements across states or comparing rental yields between cities.

Transparent property valuation for Germany

Property valuations in Germany have traditionally been opaque: an algorithm generates a number and you have no idea whether it reflects 5 recent sales or 500. The Property Valuation Germany API works differently. It calculates your estimate from the average of similar active listings in the same area, and it returns every comparable property so you can see exactly what drove the result.

Here is an example that evaluates a 100.5 sqm apartment with 2.5 rooms built in 1990 in Munich:

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())

The response includes a price estimate, a rent estimate, and a similar_properties array containing every comparable property used in the calculation. Each comparable includes its source portal, current active status, price or rent per square meter, number of rooms, year of construction, and a direct link to the original listing. For an example property in the Schwabing area of Munich, the API might return a purchase estimate near €800,000 alongside a monthly rent estimate of €2,400, backed by 20 or more comparable active listings across ImmobilienScout24, Immowelt, and Immonet.

This matters particularly for buyers making offers in a competitive market and for investors who need to justify their underwriting assumptions to partners or lenders. Munich completed only 6,503 new apartments in 2024, a 34% decline from 2023 (JLL Munich City Profile, 2025). In a supply-constrained market, knowing what comparable properties are actually transacting at is worth more than a generic algorithm estimate.

Who is Somantic built for?

Property buyers and renters

The web interface at somantic.net gives non-technical users the benefits of multi-portal aggregation without writing a line of code. Search for apartments or houses across all covered portals simultaneously, apply advanced filters, and use the AI-powered advisor to compare offers and assess pricing.

Real estate investors

Investors monitoring several regions benefit from the aggregate queries. Pull average price-per-sqm trends for a state over time, compare rental yields between Hamburg and Frankfurt, or track total active listing counts as a proxy for supply pressure. The BBSR forecasts Germany needs 320,000 new homes per year through 2030. The gap between supply and demand will not close quickly, making data-driven investment decisions increasingly valuable.

PropTech developers

The European PropTech market was valued at USD 10.79 billion in 2024 and is projected to reach USD 50.70 billion by 2033 (Market Data Forecast). Developers building property tools, market analysis dashboards, investment platforms, or buyer-facing products for Germany need reliable, multi-source data. Somantic provides that through a standard GraphQL interface available on RapidAPI, removing the need to build and maintain scrapers for each portal separately.

---

Frequently asked questions

What is Somantic?

Somantic is a German real estate intelligence platform that aggregates listings from ImmobilienScout24, Immowelt, Immonet, Kleinanzeigen, Ohne Makler, and more German portals into a single interface and a single GraphQL API. It also offers an AI-powered property advisor and a transparent property valuation API that shows comparable properties rather than a black-box estimate.

Which portals does Somantic cover?

Somantic currently covers ImmobilienScout24, Immowelt, Immonet, Kleinanzeigen, Ohne Makler, Private-Immobilienangebote, Immobilien.de, FAZ Immobilienmarkt, OVBImmo, SWP Immo, and VRM-Immo. Additional portals including Meinstadt.de and Sparkasse Immobilien are in progress.

How do I access the Somantic GraphQL API?

The easiest starting point is the developer portal at somantic.net/developers, which includes a web UI for running queries interactively and full API documentation. This endpoint is direct and independent of any third-party platform. The API is also listed on RapidAPI (somantic-net) for teams already using RapidAPI's infrastructure.

How does the Somantic property valuation API work?

The Property Valuation Germany API accepts a property's address, postcode, square meters, room count, year of construction, type (apartment or house), and city. It returns a price estimate and a rent estimate based on the average of comparable active listings in the same area. Every comparable property is returned alongside the estimate, making the valuation fully transparent.

Can I filter listings by city, state, or zip code?

Yes. The API supports filtering by city, state (using Somantic's location slug format, e.g. bl-bayern for Bavaria), zip code, action (kaufen or mieten), and specific portal. Multiple filters can be combined in a single query. Results are paginated to a maximum of 100 per page.

---