Nestoria
The easiest way to find UK property
Home >

Nestoria API - Methods - Metadata

average house price method

By using the metadata method you can request aggregated information about the current average house prices for an area. Please note - it may be much easier for you to just use our houseprice widgets in which we've done all the work for you.

For each area we take all the properties in that area, calculate the geometric mean (a complicated but more accurate average), then remove all properties beyond two median absolute deviations from the geometric mean, and calculate a new geometric mean. We do this to remove any odd outliers that might skew the data.

country example
nestoria.com.au average house price example (opens in new window)
nestoria.com.br average house price example (opens in new window)
nestoria.de average house price example (opens in new window)
nestoria.es average house price example (opens in new window)
nestoria.fr average house price example (opens in new window)
nestoria.in average house price example (opens in new window)
nestoria.it average house price example (opens in new window)
nestoria.co.uk average house price example (opens in new window)

The date from which metadata is available for each country are given in the table below.

country start date
nestoria.com.au March, 2010
nestoria.com.br March, 2011
nestoria.de September, 2009
nestoria.es October, 2007
nestoria.fr September, 2010
nestoria.in July, 2011
nestoria.it September, 2008
nestoria.co.uk October, 2007

However please note that we currently only provide the last 12 months of metadata via our API.

request

parameter description
place_name anything you would type into the search box on Nestoria: a place name, post code, tube station, etc.
e.g. "Chelsea" or "SW14"
south_west
north_east 		a bounding box in the format latitude,longitude,latitude2,longitude2
e.g. &south_west=51.684183,-3.431481&north_east=51.85415,-3.077859
centre_point latitude and longitude. A default radius of 2km will be used.
e.g. &centre_point=51.684183,-3.431481
radius latitude, longitude and a radius in either kilometres (km) or miles (mi). Note that the 'km' or 'mi' has to be set. e.g. &centre_point=51.684183,-3.431481,10km
parameter description
encoding 'json' (default) or 'xml'
pretty If set to '1' JSON output will be printed in a more readable format.

response

The response contains a number of metadata records with names such as:
  • avg_1bed_property_rent_monthly
  • avg_2bed_house_buy_quarterly
  • avg_house_rent_monthly
Each record contains sub-keys describing the property_type (property,house,flat), listing_type (buy,rent) and the number of bedrooms. It also contains a sub-key, 'data', which holds all historic data.

Example: 

      
      {
         "metadata_name" : "avg_4bed_property_buy_monthly",
         "listing_type" : "buy",
         "num_beds" : "4",
         "price_type" : "fixed",
         "property_type" : "property",
         "url" : "http://www.nestoria.co.uk/soho/property/buy/bedrooms-4/maxbed-4"
         "currency" : "GBP",
         "data" : {

            ...
            
            "2010_m1" : {
               "avg_price" : "2115444.66",
               "datapoints" : "17",
               "month" : "Jan"
            },
            "2010_m2" : {
               "avg_price" : "2124805.64",
               "datapoints" : "31",
               "month" : "Feb"
            },
            "2010_m3" : {
               "avg_price" : "2331650.08",
               "datapoints" : "50",
               "month" : "Mar"
            },

            ...

         },
      },

i.e. the monthly data showed that the average price of buying a four bedroom property (house or flat) in October 2010 was about £299,000 and in March 2010 it was about £233,000.

"2010_m3" stands for March 2010, while "2010_q3" stands for the third quarter of 2010 (July, August and September).

The response contains enough data to print historical graphs. For example: