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,
    "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/app/dashboard?coordinate=53.56238135,9.91097785903008",
    "version": "2.9.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

© 2020-2024 QUIS® ist ein Service der Analyse & Konzepte immo.analytics GmbH