Address
POST
locations/addresses
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=<YOU-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,
"dominantPopulationGroups": [
"young_adults"
],
"dominantBuildingType": "business"
},
"rentDevelopment": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"data": [
{
"x": "2011-12-31",
"y": 11.0
},
{
"x": "2012-12-31",
"y": 11.2
}
]
},
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"data": [
{
"x": "2011-12-31",
"y": 12.0
},
{
"x": "2012-12-31",
"y": 12.4
}
]
}
]
},
"salePriceDevelopment": {
"series": [
{
"divisionLevel": "divisionLevel6",
"title": "Hamburg",
"type": "apartment",
"data": [
{
"x": "2011-12-31",
"y": 3000.25
},
{
"x": "2012-12-31",
"y": 3214.25
}
]
},
{
"divisionLevel": "divisionLevel6",
"title": "Hamburg",
"type": "house",
"data": [
{
"x": "2011-12-31",
"y": 3000.25
},
{
"x": "2012-12-31",
"y": 3214.25
}
]
},
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"type": "apartment",
"data": [
{
"x": "2011-12-31",
"y": 3624.12
},
{
"x": "2012-12-31",
"y": 3824.12
}
]
},
{
"divisionLevel": "divisionLevel100",
"title": "22761",
"type": "house",
"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": {
"value": 0.023,
"class": "low"
}
},
"socialStructure": {
"incomePerHouseholdClass": "3500_to_4500",
"averageSocialClass": "upper_middle_class",
"unemploymentRate": {
"value": 0.08,
"class": "above_average"
},
"purchasingPower": {
"value": 100,
"class": "average"
},
"rentalBurden": {
"value": 0.29,
"class": "low"
}
},
"demography": {
"migrants": {
"value": 0.17,
"class": "average"
},
"householdGroups": [
{
"value": 0.78,
"class": "average",
"type": "1_to_2_people"
},
{
"value": 0.27,
"class": "average",
"type": "above_3_people"
},
...
],
"ageGroups": [
{
"value": 0.12,
"class": "average",
"type": "below_18"
},
{
"value": 0.13,
"class": "average",
"type": "18_to_29"
},
...
]
},
"qualityOfLife": {
"overall": 0.91,
"environment": 0.95,
"infrastructure": 0.87,
"neighborhood": 0.78
},
"buildingStructure": {
"buildingDensityClass": "average",
"dominantBuildingClass": "business",
"dominantBuildingYearClass": [
"below_1910",
"1911_to_1945"
],
"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,
"recreationAndNatureScore": 1.0,
"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/geo/53.56238135,9.91097785903008",
"version": "2.5.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 | |
salePriceDevelopment | The sale price development for different division levels | Chart | series.type's enum: apartment , house |
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 | |
demography | The demography of the level 20 division | Demography | |
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 |
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. | PercentageClass | vacancyRate.class `s enum: low , average , high |
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 | |
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 | well_below_average , below_average , average , above_average , well_above_average |
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 |
Demography
Field | Description | Type | Remarks |
---|---|---|---|
migrants | The share of migrants in the level 20 division | PercentageClass | |
householdGroups | The share of different household groups in the level 20 division | array of PercentageClass | householdGroups.type `s enum: 1_to_2_people , above_3_people , with_children |
ageGroups | The share of different age groups in the level 20 division | array of PercentageClass | ageGroups[i].type is of type AgeGroup |
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 | BuildingClass | |
dominantBuildingYearClasses | The dominant building year classes in the level 20 division | array of enum | below_1910 , 1911_to_1945 , 1946_to_1959 , 1960_to_1969 , 1970_to_1979 , 1980_to_1989 , 1990_to_1999 , 2000_to_2009 , above_2010 |
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 |