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"
      }
    }
  }'
FieldDescriptionTypeRemarks
locationLocation of the propertyLocation

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"
  }
}
FieldDescriptionTypeRemarks
divisionLevel20The level 20 divisionDivision
currencyThe local currencyCurrencyImportant for all kind of prices and price charts
locationThe location of the level 20 divisionLocation
scoresThe scores for the level 20 divisionScores
rentDevelopmentThe rent development for different division levelsChart
salePriceDevelopmentThe sale price development for different division levelsChartseries.type's enum: apartment, house
rentMarketDurationsThe market duration development for rent offers of different division levels in daysChart
saleMarketDurationsThe market duration development for sale offers of different division levels in daysChart
investmentRiskThe investment risk of the level 20 divisionInvestmentRisk
socialStructureThe social structure of the level 20 divisionSocialStructure
demographyThe demography of the level 20 divisionDemography
qualityOfLifeThe quality of life in the level 20 divisionQualityOfLife
buildingStructureThe building structure of the level 20 divisionBuildingStructure
infrastructureThe infrastructure of the level 20 divisionInfrastructure
metaMeta information of the APIMeta

InvestmentRisk

FieldDescriptionTypeRemarks
priceFactorobject
priceFactor.newThe number of yearly cold net rents needed to profit from buying an average recent property in the area.float
priceFactor.stockThe number of yearly cold net rents needed to profit from buying an average property in the area.float
vacancyRateThe forecasted vacancy rate in the area.PercentageClassvacancyRate.class`s enum: low, average, high

SocialStructure

FieldDescriptionTypeRemarks
incomePerHouseholdClassA classification of the average income per householdenumbelow_1500, 1500_to_2500, 2500_to_3500, 3500_to_4500, above_4500
averageSocialClassThe average social class in the level 20 divisionenumlower_class, lower_middle_class, middle_class, upper_middle_class, upper_class
unemploymentRateThe unemployment rate in the level 20 divisionPercentageClass
purchasingPowerThe average purchasing power of the inhabitants as an indexobject
purchasingPower.valueThe index value of the purchasing powerfloatA value of 100 is the average for the level 2 division
purchasingPower.classThe classification of the purchasing powerenumwell_below_average, below_average, average, above_average, well_above_average
rentalBurdenThe share of the income an average two-earner-household would have to pay for an average 65 sqm apartment in the level 20 divisionPercentageClassrentalBurden.class`s enum: very_low, low, average, high,very_high

Demography

FieldDescriptionTypeRemarks
migrantsThe share of migrants in the level 20 divisionPercentageClass
householdGroupsThe share of different household groups in the level 20 divisionarray of PercentageClasshouseholdGroups.type`s enum: 1_to_2_people, above_3_people, with_children
ageGroupsThe share of different age groups in the level 20 divisionarray of PercentageClassageGroups[i].type is of type AgeGroup

QualityOfLife

FieldDescriptionTypeRemarks
overallThe overall quality of life in the level 20 divisionScore
environmentThe environmental quality in the level 20 divisionScore
infrastructureThe infrastructure quality in the level 20 divisionScore
neighborhoodThe neighborhood quality in the level 20 divisionScore

BuildingStructure

FieldDescriptionTypeRemarks
buildingDensityClassA class describing the density of buildings in the level 20 divisionenumvery_low, low, average, high, very_high
dominantBuildingClassThe dominant building classes in the level 20 divisionBuildingClass
dominantBuildingYearClassesThe dominant building year classes in the level 20 divisionarray of enumbelow_1910, 1911_to_1945, 1946_to_1959, 1960_to_1969, 1970_to_1979, 1980_to_1989, 1990_to_1999, 2000_to_2009, above_2010
dominantNumberOfFloorsThe dominant number of floors in the level 20 divisionarray of enumone, two, three, four, five, six, seven, eight, nine_to_twelve, above_13