Addresses
POST /locations/addresses HTTP/2
Get information on the lowest division level, such as scores, demographics, infrastructure, and investment risks.
Example use-cases:
- Display scores for the specified location
- Display distances to important different points of interest, such as schools or restaurants
- Calculate your investment risks with the demographics and scores
Request
curl -X POST 'https://quis.de/api/v2/locations/addresses?api_key=<YOUR-API-KEY>' \
-H 'Content-Type: application/json' \
-d '{
"location": {
"address": {
"street": "Gasstraße",
"houseNumber": "10",
"postCode": "22761",
"city": "Hamburg"
}
}
}'
| Field | Description | Type | Remarks |
|---|---|---|---|
| location | Location of the property | Location |
Response
{
"divisionLevel20": {
"id": "02000000007000000579",
"name": "Gasstraße 10, 22671 Hamburg",
"levelDesignation": "Quartier",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
9.8845262,
53.580345
],
...
]
]
]
}
},
"currency": "EUR",
"location": {
"address": {
"street": "Gasstraße",
"houseNumber": "10",
"postCode": "22761",
"city": "Hamburg"
},
"coordinates": {
"latitude": 53.561262,
"longitude": 9.9138307
}
},
"scores": {
"overall": 0.87,
"socialStructure": 0.72,
"infrastructure": 0.81,
"rentPrice": 0.92,
"qualityOfLife": 0.81,
},
"rentDevelopment": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"type": "apartment_stock",
"data": [
{
"x": "2011-12-31",
"y": 11.0
},
{
"x": "2012-12-31",
"y": 11.2
}
]
},
...
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"type": "apartment_new",
"data": [
{
"x": "2011-12-31",
"y": 12.0
},
{
"x": "2012-12-31",
"y": 12.4
}
]
}
]
},
"salePriceDevelopment": {
"series": [
{
"divisionLevel": "divisionLevel6",
"title": "Hamburg",
"type": "apartment_stock",
"data": [
{
"x": "2011-12-31",
"y": 3000.25
},
{
"x": "2012-12-31",
"y": 3214.25
}
]
},
...
{
"divisionLevel": "divisionLevel6",
"title": "Hamburg",
"type": "house_new",
"data": [
{
"x": "2011-12-31",
"y": 3000.25
},
{
"x": "2012-12-31",
"y": 3214.25
}
]
},
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"type": "apartment_stock",
"data": [
{
"x": "2011-12-31",
"y": 3624.12
},
{
"x": "2012-12-31",
"y": 3824.12
}
]
},
...
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"type": "house_new",
"data": [
{
"x": "2011-12-31",
"y": 3624.12
},
{
"x": "2012-12-31",
"y": 3824.12
}
]
}
]
},
"rentMarketDurations": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"type": "house",
"data": [
{
"x": "2020-05-31",
"y": 8.25
},
{
"x": "2020-06-30",
"y": 8.25
}
]
},
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"data": [
{
"x": "2020-05-31",
"y": 5.25
},
{
"x": "2020-06-30",
"y": 5.25
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "2020-05-31",
"y": 25.25
},
{
"x": "2020-06-30",
"y": 25.25
}
]
}
]
},
"saleMarketDurations": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"data": [
{
"x": "2020-05-31",
"y": 40.25
},
{
"x": "2020-06-30",
"y": 40.25
}
]
},
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"data": [
{
"x": "2020-05-31",
"y": 30.25
},
{
"x": "2020-06-30",
"y": 30.25
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "2020-05-31",
"y": 80.25
},
{
"x": "2020-06-30",
"y": 80.25
}
]
}
]
},
"investmentRisk": {
"priceFactor": {
"new": 31.31,
"stock": 31.31
},
"vacancyRate": 0.055
},
"socialStructure": {
"incomePerHouseholdClass": "3500_to_4500",
"averageSocialClass": "upper_middle_class",
"unemploymentRate": {
"value": 0.08,
"class": "high"
},
"migrants": {
"value": 0.03,
"class": "low"
},
"purchasingPower": {
"value": 100,
"class": "average"
},
"rentalBurden": {
"value": 0.29,
"class": "low"
}
},
"ageGroup": {
"below18": 0.09,
"between18And30": 0.12,
"between30And45": 0.25,
"between45And65": 0.24,
"between65And75": 0.2,
"above75": 0.1
},
"household": {
"child": 0.3,
"onePerson": 0.3,
"twoPerson": 0.3,
"threePerson": 0.25,
"fourOrMorePerson": 0.25
},
"qualityOfLife": {
"overall": 0.91,
"environment": 0.95,
"infrastructure": 0.87,
"neighborhood": 0.78
},
"buildingStructure": {
"buildingDensityClass": "average",
"dominantBuildingClass": "business",
"dominantBuildingYearClass": [
"below_1919",
"1920_to_1949"
],
"dominantNumberOfFloors": [
"one",
"above_13"
]
},
"infrastructure": {
"dailyNeeds": {
"score": 0.85,
"nextSupermarket": {
"distance": 600.0,
"name": null
},
"nextBakery": {
"distance": 500.0,
"name": null
},
"nextRestaurant": {
"distance": 200.0,
"name": null
}
},
"transport": {
"score": 0.85,
"nextBusStop": {
"distance": 200.0,
"name": null
},
"nextTrainStation": {
"distance": 1600.0,
"name": null
},
"nextAirport": null,
"nextChargingStation": {
"distance": 3800.0,
"name": null
}
},
"education": {
"score": 0.7,
"nextChildDayCare": {
"distance": 600.0,
"name": "Kindergarten Nordergraben 3"
},
"nextPrimarySchool": {
"distance": 1200.0,
"name": "Hohlwegschule"
},
"nextHighSchool": {
"distance": 1700.0,
"name": "Käte-Lassen-Schule"
},
"nextGrammarSchool": {
"distance": 1000.0,
"name": "Altes Gymnasium"
}
},
"healthAndSport": {
"score": 1.0,
"recreationAndNaturePercentage": 0.55,
"nextFamilyDoctor": {
"distance": 1000.0,
"name": null
},
"nextHospital": {
"distance": 1500.0,
"name": null
},
"nextPharmacy": {
"distance": 400.0,
"name": null
},
"nextSportFacility": {
"distance": 300.0,
"name": null
}
},
"noisePollution": {
"score": 0.8,
"roadLevel": "below_55",
"trainLevel": "below_55"
}
},
"meta": {
"url": "https://quis.de/app/dashboard?coordinate=53.56238135,9.91097785903008",
"version": "2.15.0"
}
}
| Field | Description | Type | Remarks |
|---|---|---|---|
| divisionLevel20 | The level 20 division | Division | |
| currency | The local currency | Currency | Important for all kind of prices and price charts |
| location | The location of the level 20 division | Location | |
| scores | The scores for the level 20 division | Scores | |
| rentDevelopment | The rent development for different division levels | Chart | series.type’s enum: apartment_stock, apartment_new, house_stock house_new |
| salePriceDevelopment | The sale price development for different division levels | Chart | series.type’s enum: apartment_stock, apartment_new, house_stock house_new |
| rentMarketDurations | The market duration development for rent offers of different division levels in days | Chart | |
| saleMarketDurations | The market duration development for sale offers of different division levels in days | Chart | |
| investmentRisk | The investment risk of the level 20 division | InvestmentRisk | |
| socialStructure | The social structure of the level 20 division | SocialStructure | |
| ageGroup | The age groups of the level 20 division | AgeGroup | |
| household | The households of the level 20 division | Household | |
| qualityOfLife | The quality of life in the level 20 division | QualityOfLife | |
| buildingStructure | The building structure of the level 20 division | BuildingStructure | |
| infrastructure | The infrastructure of the level 20 division | Infrastructure | |
| meta | Meta information of the API | Meta |
Scores
| Field | Description | Type | Remarks |
|---|---|---|---|
| overall | The overall score | Score | |
| socialStructure | The social structure score | Score | |
| infrastructure | The infrastructure score | Score | |
| rentPrice | The rent price score | Score | |
| qualityOfLife | The quality of life score | Score |
InvestmentRisk
| Field | Description | Type | Remarks |
|---|---|---|---|
| priceFactor | object | ||
| priceFactor.new | The number of yearly cold net rents needed to profit from buying an average recent property in the area. | float | |
| priceFactor.stock | The number of yearly cold net rents needed to profit from buying an average property in the area. | float | |
| vacancyRate | The forecasted vacancy rate in the area. | float |
SocialStructure
| Field | Description | Type | Remarks |
|---|---|---|---|
| incomePerHouseholdClass | A classification of the average income per household | enum | below_1500, 1500_to_2500, 2500_to_3500, 3500_to_4500, above_4500 |
| averageSocialClass | The average social class in the level 20 division | enum | lower_class, lower_middle_class, middle_class, upper_middle_class, upper_class |
| unemploymentRate | The unemployment rate in the level 20 division | PercentageClass | unemploymentRate.class`s enum: very_low, low, average, high,very_high |
| migrants | The share of migrants in the level 20 division | PercentageClass | migrants.class`s enum: very_low, low, average, high,very_high |
| purchasingPower | The average purchasing power of the inhabitants as an index | object | |
| purchasingPower.value | The index value of the purchasing power | float | A value of 100 is the average for the level 2 division |
| purchasingPower.class | The classification of the purchasing power | enum | very_low, low, average, high,very_high |
| rentalBurden | The share of the income an average two-earner-household would have to pay for an average 65 sqm apartment in the level 20 division | PercentageClass | rentalBurden.class`s enum: very_low, low, average, high,very_high |
QualityOfLife
| Field | Description | Type | Remarks |
|---|---|---|---|
| overall | The overall quality of life in the level 20 division | Score | |
| environment | The environmental quality in the level 20 division | Score | |
| infrastructure | The infrastructure quality in the level 20 division | Score | |
| neighborhood | The neighborhood quality in the level 20 division | Score |
BuildingStructure
| Field | Description | Type | Remarks |
|---|---|---|---|
| buildingDensityClass | A class describing the density of buildings in the level 20 division | enum | very_low, low, average, high, very_high |
| dominantBuildingClass | The dominant building classes in the level 20 division | enum | one_or_two_family_house, apartment_building, high_rise, business, special, unknown |
| dominantBuildingYearClasses | The dominant building year classes in the level 20 division | array of enum | below_1919, 1920_to_1949, 1950_to_1979, 1980_to_1989, 1990_to_1999, 2000_to_2009, 2010_to_2019, above_2020 |
| dominantNumberOfFloors | The dominant number of floors in the level 20 division | array of enum | one, two, three, four, five, six, seven, eight, nine_to_twelve, above_13 |
Infrastructure
| Field | Description | Type | Remarks |
|---|---|---|---|
| dailyNeeds | object | ||
| dailyNeeds.score | The score of the availability of daily needs | Score | |
| dailyNeeds.nextSupermarket | Next supermarket | PointOfInterest | |
| dailyNeeds.nextBakery | Next bakery | PointOfInterest | |
| dailyNeeds.nextRestaurant | Next restaurant | PointOfInterest | |
| dailyNeeds.nextShoppingCenter | Next shopping center | PointOfInterest | |
| transport | object | ||
| transport.score | The score of the availability of transportation | Score | |
| transport.nextBusStop | Next bus stop | PointOfInterest | |
| transport.nextTrainStation | Next train station | PointOfInterest | |
| transport.nextAirport | Next airport | PointOfInterest | |
| transport.nextChargingStation | Next electric vehicle charging station | PointOfInterest | |
| education | object | ||
| education.score | The score of the availability of education facilities | Score | |
| education.nextChildDayCare | Next child day care | PointOfInterest | |
| education.nextPrimarySchool | Next primary school | PointOfInterest | |
| education.nextHighSchool | Next high school | PointOfInterest | |
| education.nextGrammarSchool | Next grammar school | PointOfInterest | |
| education.nextUniversity | Next university | PointOfInterest | |
| healthAndSport | object | ||
| healthAndSport.score | The score of the availability of health and sport facilities | Score | |
| healthAndSport.recreationAndNaturePercentage | Percentage of recreation and nature in the surrounding area | float | |
| healthAndSport.nextFamilyDoctor | Next family doctor | PointOfInterest | |
| healthAndSport.nextHospital | Next hospital | PointOfInterest | |
| healthAndSport.nextPharmacy | Next pharmacy | PointOfInterest | |
| healthAndSport.nextPlayground | Next playground | PointOfInterest | |
| healthAndSport.nextSportFacility | Next sport facility | PointOfInterest | |
| emergencyServices | object | ||
| emergencyServices.score | The score of the availability of emergency services | Score | |
| emergencyServices.nextFireStation | Next fire station | PointOfInterest | |
| emergencyServices.nextPoliceStation | Next police station | PointOfInterest | |
| noisePollution | object | ||
| noisePollution.score | The score rating the noise pollution | Score | |
| noisePollution.roadLevel | The noise pollution level caused by road traffic | VolumeLevel | |
| noisePollution.trainLevel | The noise pollution level caused by rail traffic | VolumeLevel | |
| noisePollution.airportLevel | The noise pollution level caused by air traffic | VolumeLevel | |
| noisePollution.industryLevel | The noise pollution level caused by industry | VolumeLevel |