Property tracker

POST property_tracker

Returns insights about a dossier such as the valuation for today and for a date in the past, nearby offers and building projects as well as market trends.

curl -X POST 'https://api.pricehubble.com/api/v1/property_tracker?access_token=74126eab0a9048d993bda4b1b55ae074' \
  -H 'Content-Type: application/json' \
  -d '{
    "countryCode":"FR",
    "dossierId":"434f6661-6f5b-448f-ab80-56b8bb76d160",
    "date": "2021-01-01",
    "radius": 50
  }'

Field	Description	Type	Remarks
dossierId	The ID of the dossier	UUID
date	date to be valuated against	Date	date format: "YYYY-MM-DD".
countryCode	ISO country code	string
radius	Radius in meter for offers and building project around the dossier	integer	default: 200
usePostalCode	Put true if you want to get offers in the same postcode area than the dossier. Takes priority over radius.	boolean	default: false, does no apply to building projects for which radius always apply

Response

{
  "valuations":[
    {
      "confidence":"good",
      "coordinates":{
        "latitude":48.8443662,
        "longitude":2.3562666
      },
      "currency":"EUR",
      "salePrice":66400,
      "salePriceRange":{
        "lower":61100,
        "upper":71700
      },
      "value":66400,
      "valueRange":{
        "lower":61100,
        "upper":71700
      }
    },
    {
      "confidence":"good",
      "coordinates":{
        "latitude":48.8443662,
        "longitude":2.3562666
      },
      "currency":"EUR",
      "salePrice":68900,
      "salePriceRange":{
        "lower":63400,
        "upper":74500
      },
      "value":68900,
      "valueRange":{
        "lower":63400,
        "upper":74500
      }
    }
  ],
  "valuationChangePercent":3.8,
  "offers":{
    "items":[
      {
        ...
      },
    ],
    "totalItems":2
  },
  "building_projects":{
    "items":[
      ...
    ],
    "totalItems":3
  }
}

Field	Description	Type	Remarks
valuations	List of 2 valuations, first one for the given date, second one for today	List of Valuations
valuationChangePercent	Difference of the valuations at the requested date and today, given in percent and rounded to 1 digit	float	Given an increase in price of 21.57%, the number returned will be 21.6
offers.items	List of offers in the given radius	List of Offers	Limited to 500
offers.totalItems	Total number of offers found	integer
building_projects.items	List of building projects in the given radius	List of Building projects	Limited to 500
building_projects.totalItems	Total number of building projects found	integer
trends	The market trends of price per square meter of the given date and today	Array of Market Trends

Market Trend

The trend is the average of the price per square meter of the offers similar in living area to the dossier in the chosen area

Field	Description	Type	Remarks
dateRange	Offers published during this period will be considered	object	The first daterange is around the given date and the second one is just before today
dateRange.min	Start of the period	datetime
dateRange.max	End of the period	datetime
value	Average price per square meter of offers	float
count	Number of offers used to calculate the value	integer