Building block

GET https://quis.de/api/v1/block?api_key=<YOUR-API-KEY>&address=<YOUR-ADDRESS> HTTP/2

The building block endpoint provides all static data, known from the QUIS building block dashboard.

Parameters

Either the address or coordinate parameter is required. If both are provided, the address will be used.

parameterdescription
api_keyRequired Your API key, find more information in the authentication section
addressThe address will be used to find the building block. For more precise results, use addresses in the following format: street house_number, postal_code city
coordinateThe coordinate will be used to find the building block.

Example

Your response may vary a little bit in structure depending on your region and the type of city. The provided data has random values to give you a feeling about the format you can expect.

GET https://quis.de/api/v1/block?api_key=<YOUR-API-KEY>&address=gasstraße,hamburg HTTP/2
{
  "address": {
    "street": "Bahrenfelder Kirchenweg 38",
    "postcode": "22761",
    "city": "Hamburg",
    "district": "Bahrenfeld",
    "county": "Hamburg",
    "state": "HH",
    "latitude": 53.56238135,
    "longitude": 9.91097785903008,
    "geo_json": {
      "type": "MultiPolygon",
      "coordinates": [
        [
          [
            [
              9.91187304,
              53.56373616
            ],
            [
              9.91192432,
              53.5634548
            ],
            ...
          ]
        ]
      ]
    }
  },
  "rating": {
    "total": 8.2,
    "social": 6.2,
    "infrastructure": 7.2,
    "rent": 6.3,
    "demography": "junge Erwachsene",
    "building": "Mehrfamilienhaus"
  },
  "prices": {
    "rent": {
      "development": {
        "title": "Mietentwicklung",
        "series": [
          {
            "title": "PLZ 22761",
            "region_type": "zipcode",
            "data": {
              "2012": {
                "y": 10.54,
                "delta": ""
              },
              "2013": {
                "y": 12.12,
                "delta": "(-2,12% zum Vorjahr, n = 358)"
              },
              ...
              "2024": {
                "y": 12.50,
                "delta": "(3,54 % zum Vorjahr)",
                "gamma": "80% Prognoseintervall: (12,01 €, 12,90 €)"
              }
            }
          },
          {
            "title": "Kreisfreie Stadt Hamburg",
            "region_type": "county",
            "data": {
              "2012": {
                "y": 11.11,
                "delta": ""
              },
              "2013": {
                "y": 10.10,
                "delta": " (+2,12% zum Vorjahr, n = 29.813)"
              },
              ...
              "2024": {
                "y": 10.3,
                "delta": "(3,41 % zum Vorjahr)",
                "gamma": "80% Prognoseintervall: (9,34 €, 11,39 €)"
              }
            }
          }
        ]
      },
      "marketing_duration": {
        "title": "Vermarktungsdauer",
        "series": [
          {
            "title": "PLZ 22761",
            "region_type": "zipcode",
            "data": {
              "2018-09-01": 4.22,
              "2018-10-01": 4.22,
              ...
            }
          },
          {
            "title": "Kreisfreie Stadt Hamburg",
            "region_type": "county",
            "data": {
              "2018-09-01": 7.97,
              "2018-10-01": 7.97,
              ...
            }
          },
          {
            "title": "Deutschland",
            "region_type": "country",
            "data": {
              "2018-09-01": 13.93,
              "2018-10-01": 13.93,
              ...
            }
          }
        ]
      }
    },
    "purchase": {
      "development": {
        "title": "Preisentwicklung für Eigentumswohnungen",
        "series": [
          {
            "title": "PLZ 22761",
            "region_type": "zipcode",
            "data": {
              "2012": {
                "y": 3000.74,
                "delta": ""
              },
              "2013": {
                "y": 3000.36,
                "delta": " (+15,53% zum Vorjahr, n = 142)"
              },
              ...
              "2024": {
                "y": 3147.59,
                "delta": "(10,47 % zum Vorjahr)",
                "gamma": "80% Prognoseintervall: (2.377,20 €, 4.178,09 €)"
              }
            }
          },
          {
            "title": "Kreisfreie Stadt Hamburg",
            "region_type": "county",
            "data": {
              "2012": {
                "y": 3000.6,
                "delta": ""
              },
              "2013": {
                "y": 3000.33,
                "delta": " (+15,53%zum Vorjahr, n = 10.459)"
              },
              ...
              "2024": {
                "y": 4201.83,
                "delta": "(9,41 % zum Vorjahr)",
                "gamma": "80% Prognoseintervall: (3.627,23 €, 4.885,81 €)"
              }
            }
          }
        ]
      },
      "marketing_duration": {
        "title": "Vermarktungsdauer",
        "series": [
          {
            "title": "PLZ 22761",
            "region_type": "zipcode",
            "data": {
              "2018-09-01": 30.04,
              "2018-10-01": 30.37,
              ...
            }
          },
          {
            "title": "Kreisfreie Stadt Hamburg",
            "region_type": "county",
            "data": {
              "2018-09-01": 23.05,
              "2018-10-01": 25.72,
              ...
            }
          },
          {
            "title": "Deutschland",
            "region_type": "country",
            "data": {
              "2018-09-01": 24.49,
              "2018-10-01": 31.33,
              ...
            }
          }
        ]
      }
    }
  },
  "investment_risk": {
    "price_factor": {
      "stock": 28.1,
      "new": 30.5
    },
    "vacancy_rate": {
      "class": "niedrig",
      "percent": 2.9
    }
  },
  "social_structure": {
    "unemployed": {
      "class": "durchschnittlich",
      "pclass": "6 % – 8 %"
    },
    "purchasing_power": {
      "class": "durchschnittlich",
      "index": "105 – 110"
    },
    "income": "1500 € – 2500 €",
    "social_class": "Mittelschicht",
    "wohnkonzept": "Anspruchsvolle",
    "rental_burden": {
      "class": "durchschnittlich",
      "percent": 30
    }
  },
  "demography": {
    "foreigners": {
      "class": "überdurchschnittlich",
      "pclass": "20 % – 22 %"
    },
    "households": {
      "children": {
        "class": "unterdurchschnittlich",
        "pclass": "20 % – 22 %"
      },
      "1-2_persons": {
        "class": "unterdurchschnittlich",
        "pclass": "20 % – 22 %"
      },
      "3+_persons": {
        "class": "unterdurchschnittlich",
        "pclass": "20 % – 22 %"
      }
    },
    "age": {
      "0-18": {
        "class": "unterdurchschnittlich",
        "pclass": "10 % – 12 %"
      },
      "18-30": {
        "class": "unterdurchschnittlich",
        "pclass": "10 % – 12 %"
      },
      "30-45": {
        "class": "unterdurchschnittlich",
        "pclass": "10 % – 12 %"
      },
      "45-65": {
        "class": "unterdurchschnittlich",
        "pclass": "10 % – 12 %"
      },
      "65+": {
        "class": "unterdurchschnittlich",
        "pclass": "10 % – 12 %"
      }
    }
  },
  "infrastructure": {
    "neighborhood": {
      "subrating": 5,
      "grocery": "< 500 m",
      "bakery": "< 300 m",
      "restaurant": "< 500 m"
    },
    "family": {
      "subrating": 4.6,
      "child_care": 500,
      "primary_school": 400,
      "comprehensive_school": 900,
      "grammar_school": 1900
    },
    "noise": {
      "subrating": 5,
      "street": "< 55 dB(A)",
      "rail": "< 55 dB(A)"
    },
    "mobility": {
      "subrating": 4.8,
      "bus": "< 300 m",
      "train": "< 1000 m",
      "airport": 12500,
      "ev_charging_station": 600
    },
    "health": {
      "subrating": 3.6,
      "doctor": "< 300 m",
      "hospital": "1500 m",
      "pharmacy": "< 300 m",
      "recreation": "stark unterdurchschnittlich",
      "sports": 100
    }
  },
  "building_structure": {
    "density": "durchschnittlich",
    "floors": "vier, drei",
    "year": "≤ 1910",
    "type": "Mehrfamilienhaus"
  },
  "region": {
    "city": {
      "name": "Hamburg",
      "type": "große Großstadt",
      "population": 1830584,
      "broadband_availability": {
        "class": "versorgt",
        "percent": 98
      },
      "geo_json": {
        "type": "MultiPolygon",
        "coordinates": [
          [
            [
              [
                10.1856842014319,
                53.7312916117363
              ],
              [
                10.1889174364788,
                53.7304552357376
              ],
              ...
            ]
          ],
          ...
        ]
      }
    },
    "postal_code": {
      "code": "22761",
      "geo_json": {
        "type": "MultiPolygon",
        "coordinates": [
          [
            [
              [
                9.8845262,
                53.580345
              ],
              [
                9.8845886,
                53.580431
              ],
              ...
            ]
          ]
        ]
      }
    },
    "county": {
      "name": "Kreisfreie Stadt Hamburg",
      "future_potential": 10
    },
    "state": {
      "name": "Hamburg"
    },
    "population_development": {
      "title": "Einwohnerzahl",
      "series": [
        {
          "title": "Stadt Hamburg",
          "region_type": "municipality",
          "data": {
            "2011": 100.0,
            "2012": 100.94,
            ...
          }
        },
        {
          "title": "Deutschland",
          "region_type": "country",
          "data": {
            "2011": 100.0,
            "2012": 100.24,
            ...
          }
        }
      ]
    },
    "population_forecast": {
      "title": "Bevölkerungsprognose",
      "region_type": "county",
      "series": [
        {
          "title": "unter 20 Jahre",
          "data": {
            "2015": 100.0,
            "2016": 100.19,
            ..
            "2034": 97.22,
            "2035": 97.22
          }
        },
        {
          "title": "20 bis unter 30 Jahre",
          "data": {
            "2015": 100.0,
            "2016": 100.89,
            ...
            "2034": 100.0,
            "2035": 97.22
          }
        },
        {
          "title": "30 bis unter 65 Jahre",
          "data": {
            "2015": 100.0,
            "2016": 100.61,
            ...
            "2034": 100.0,
            "2035": 100.0
          }
        },
        {
          "title": "65 bis unter 80 Jahre",
          "data": {
            "2015": 100.0,
            "2016": 99.67,
            ...
            "2034": 97.22,
            "2035": 97.22
          }
        },
        {
          "title": "80 Jahre und älter",
          "data": {
            "2015": 100.0,
            "2016": 104.45,
            ...
            "2034": 130.12,
            "2035": 130.12
          }
        },
        {
          "title": "insgesamt",
          "data": {
            "2015": 100.0,
            "2016": 100.65,
            ...
            "2034": 100.65,
            "2035": 100.65
          }
        }
      ]
    },
    "population_pyramid": {
      "title": "Bevölkerungspyramide",
      "region_type": "municipality",
      "series": [
        {
          "title": "Stadt Hamburg",
          "data": {
            "unter 18 Jahre": 16.54,
            "18 bis unter 30 Jahre": 16.54,
            "30 bis unter 45 Jahre": 16.54,
            "45 bis unter 65 Jahre": 16.54,
            "65 bis unter 75 Jahre": 16.54,
            "75 Jahre und älter": 16.54
          }
        },
        {
          "title": "große Großstadt",
          "data": {
            "unter 18 Jahre": 16.54,
            "18 bis unter 30 Jahre": 16.54,
            "30 bis unter 45 Jahre": 16.54,
            "45 bis unter 65 Jahre": 16.54,
            "65 bis unter 75 Jahre": 16.54,
            "75 Jahre und älter": 16.54
          }
        }
      ]
    },
    "population_by_age": {
      "title": "Einwohnerzahl nach Alter",
      "region_type": "municipality",
      "series": [
        {
          "title": "unter 18 Jahre",
          "data": {
            "2011": 100.0,
            "2012": 100.97,
            ...
          }
        },
        {
          "title": "18 bis unter 30 Jahre",
          "data": {
            "2011": 100.0,
            "2012": 101.13,
            ...
          }
        },
        {
          "title": "30 bis unter 45 Jahre",
          "data": {
            "2011": 100.0,
            "2012": 99.92,
            ...
          }
        },
        {
          "title": "45 bis unter 65 Jahre",
          "data": {
            "2011": 100.0,
            "2012": 102.05,
            ...
          }
        },
        {
          "title": "65 bis unter 75 Jahre",
          "data": {
            "2011": 100.0,
            "2012": 98.11,
            ...
          }
        },
        {
          "title": "75 Jahre und älter",
          "data": {
            "2011": 100.0,
            "2012": 103.31,
            ...
          }
        }
      ]
    },
    "migration_balance": {
      "title": "Wanderungssaldo",
      "region_type": "municipality",
      "series": [
        {
          "title": "Zuzüge",
          "data": {
            "2011": 5.43,
            "2012": 5.43,
            ...
          }
        },
        {
          "title": "Fortzüge",
          "data": {
            "2011": 4.73,
            "2012": 4.56,
            ...
          }
        },
        {
          "title": "Insgesamt",
          "data": {
            "2011": 0.71,
            "2012": 0.86,
            ...
          }
        }
      ]
    },
    "construction_completions": {
      "title": "Baufertigstellungen",
      "region_type": "municipality",
      "series": [
        {
          "title": "Wohnungen in Wohngebäuden mit 1–2 Wohnungen",
          "data": {
            "2011": 7.12,
            "2012": 6.28,
            ...
          }
        },
        {
          "title": "Wohnungen in Wohngebäuden mit 3 und mehr Wohnungen",
          "data": {
            "2011": 12.12,
            "2012": 12.8,
            ...
          }
        }
      ]
    },
    "unemployment_rates": {
      "title": "Arbeitslosen- und Mindestsicherungsquote",
      "region_type": "county",
      "series": [
        {
          "title": "Arbeitslosenquote",
          "data": {
            "2011": 7.8,
            "2012": 7.5,
            ...
          }
        },
        {
          "title": "Mindestsicherungsquote",
          "data": {
            "2011": 13.0,
            "2012": 12.9,
            ...
          }
        }
      ]
    },
    "migrant_share": {
      "title": "Migrantenanteil",
      "series": [
        {
          "title": "Kreisfreie Stadt Hamburg",
          "region_type": "county",
          "data": {
            "2011": 12.73,
            "2012": 13.05,
            ...
          }
        },
        {
          "title": "Deutschland",
          "region_type": "country",
          "data": {
            "2011": 7.9,
            "2012": 8.25,
            ...
          }
        }
      ]
    },
    "available_income": {
      "title": "Verfügbares Einkommen",
      "series": [
        {
          "title": "Kreisfreie Stadt Hamburg",
          "region_type": "county",
          "data": {
            "2017": 20000.00
          }
        },
        {
          "title": "Deutschland",
          "region_type": "country",
          "data": {
            "2017": 20000.00
          }
        }
      ]
    },
    "income": {
      "title": "Einkommen",
      "series": [
        {
          "title": "Kreisfreie Stadt Hamburg",
          "region_type": "county",
          "data": {
            "2011": 100.0,
            "2012": 101.22,
            ...
          }
        },
        {
          "title": "Deutschland",
          "region_type": "country",
          "data": {
            "2011": 100.0,
            "2012": 102.26,
            ...
          }
        }
      ]
    }
  },
  "meta": {
    "url": "https://quis.de/geo/53.56238135,9.91097785903008",
    "version": "1.10.1"
  }
}