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,
    "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": "divisionLevel8",
        "title": "Hamburg",
        "data": [
          {
            "x": "2011-12-31",
            "y": 3000.25
          },
          {
            "x": "2012-12-31",
            "y": 3214.25
          }
        ]
      },
      {
        "divisionLevel": "divisionLevel100",
        "title": "22761",
        "data": [
          {
            "x": "2011-12-31",
            "y": 3624.12
          },
          {
            "x": "2012-12-31",
            "y": 3824.12
          }
        ]
      }
    ]
  },
  "rentMarketDurations": {
    "series": [
      {
        "divisionLevel": "divisionLevel8",
        "title": "Hamburg",
        "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"
      },
      ...
    ],
  },
  "buildingStructure": {
    "buildingDensityClass": "average",
    "dominantBuildingClass": "business",
    "dominantBuildingYearClass": ["below_1910", "1911_to_1945"],
    "dominantNumberOfFloors": ["one", "above_13"]
  },
  "infrastructure": {
    "dailyNeeds": {
      "score": 0.87,
      "nextSupermarket": 250.25,
      "nextBackery": 250.25,
      "nextRestaurant": 250.25,
    },
    "transport": {
      "score": 0.87,
      "nextBusStop": 250.25,
      "nextTrainStation": 250.25,
      "nextAirport": 250.25,
      "nextChargingStation": 250.25,
    },
    "education": {
      "score": 0.87,
      "nextChildDayCare": 250.25,
      "nextPrimarySchool": 250.25,
      "nextHighSchool": 250.25,
      "nextGrammarSchool": 250.25,
    },
    "healthAndSport": {
      "score": 0.87,
      "recreationAndNatureScore": 0.87,
      "nextFamilyDoctor": 250.25,
      "nextHospital": 250.25,
      "nextPharmacy": 250.25,
      "nextSportFacility": 250.25,
    },
    "noisePollution": {
      "score": 0.87,
      "streetLevel": "below_55",
      "trainLevel": "below_55",
    }
  },
  "meta": {
    "url": "https://quis.de/geo/53.56238135,9.91097785903008",
    "version": "2.1.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 levelsChart
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
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

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

Infrastructure

FieldDescriptionTypeRemarks
dailyNeedsobject
dailyNeeds.scoreThe score of the availability of daily needs near the level 20 divisionScore
dailyNeeds.nextSupermarketNext supermarketPointOfInterest
dailyNeeds.nextBackeryNext backeryPointOfInterest
dailyNeeds.nextRestaurantNext restaurantPointOfInterest
transportobject
transport.scoreThe score of the availability of transportation near the level 20 divisionScore
transport.nextBusStopNext bus stopPointOfInterest
transport.nextTrainStationNext train stationPointOfInterest
transport.nextAirportNext airportPointOfInterest
transport.nextChargingStationNext electric vehicle charging stationPointOfInterest
educationobject
education.scoreThe score of the availability of education facilities near the level 20 divisionScore
education.nextChildDayCareNext child day carePointOfInterest
education.nextPrimarySchoolNext primary schoolPointOfInterest
education.nextHighSchoolNext high schoolPointOfInterest
education.nextGrammarSchoolNext grammar schoolPointOfInterest
healthAndSportobject
healthAndSport.scoreThe score of the availability of health and sport facilities near the level 20 divisionScore
healthAndSport.recreationAndNatureScoreThe score rating the recreation and nature around the level 20 divisionScore
healthAndSport.nextFamilyDoctorNext family doctorPointOfInterest
healthAndSport.nextHospitalNext hospitalPointOfInterest
healthAndSport.nextPharmacyNext pharmacyPointOfInterest
healthAndSport.nextSportFacilityNext sport facilityPointOfInterest
noisePollutionobject
noisePollution.scoreThe score rating the noise pollution around the level 20 divisionScore
noisePollution.roadLevelThe noise pollution level caused by road trafficVolumeLevel
noisePollution.trainLevelThe noise pollution level caused by rail trafficVolumeLevel