Market

POST /mercato

Statistics of the listings currently on the market in the same micro zone as the property, together with the zone the sample was taken from.

Example Request

curl --location 'https://appraisal.realitycs.it/mercato' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'request_uid=a5108688-bf46-4b0a-b6b9-756396769cba' \
--data-urlencode 'contratto_id=1'

Request Fields

Field	Required	Default	Description	Type	Example	Notes
`request_uid`	yes		Identifier of the request	string	`a5108688-bf46-4b0a-b6b9-756396769cba`	UUID
`contratto_id`	optional	`1`	Contract type	number	`1`	`1` = sale, `2` = rent

JSON keys in the response:

stats.qt: Number of listings the statistics are computed on.
stats.prezzo_mean: Average price of the sample, in € for sale and in €/month for rent.
stats.prezzo_mq_mean: Average unit price of the sample, in €/m² for sale and in €/m² per month for rent.
stats.mesi_mean: Average time the listings have been on the market, in months.
stats.locali: Distribution of the sample by number of rooms, in percentage. The >5 key groups everything above five rooms.
stats.stato: Distribution of the sample by maintenance condition, in percentage.
stats.ascensore: Distribution of the sample by presence of a lift, in percentage.
stats.box_auto: Distribution of the sample by presence of a garage, in percentage.
zone: Micro zones the sample was taken from.
zone[].id: Identifier of the zone.
zone[].nome: Name of the zone.
zone[].comune: Municipality of the zone.
zone[].geometry: Encrypted geometry of the zone, see the note below.
zone[].geometry_type: Type of the geometry, always encrypted.

Units depend on contratto_id

With contratto_id=1 prices are sale prices, with contratto_id=2 they are monthly rents. The whole sample changes accordingly, so the distributions are not comparable between the two calls.

Encrypted geometries

zone[].geometry holds an opaque encrypted token and geometry_type is set to encrypted. The token is meant to be forwarded to the Immobiliare.it mapping components, it cannot be decoded client side.

Example Response

{
  "stats": {
    "ascensore": {
      "con_ascensore": 100.0,
      "senza_ascensore": 0
    },
    "box_auto": {
      "con_box": 0,
      "senza_box": 100.0
    },
    "locali": {
      "1": 14.29,
      "2": 14.29,
      "3": 14.29,
      "4": 42.86,
      "5": 0,
      ">5": 14.29
    },
    "mesi_mean": 3.44,
    "prezzo_mean": 1599000.0,
    "prezzo_mq_mean": 13745.8,
    "qt": 7,
    "stato": {
      "buono_abitabile": 14.29,
      "non_ristrutturato": 0,
      "nuovo_in_costruzione": 28.57,
      "ottimo_ristrutturato": 57.14
    }
  },
  "zone": [
    {
      "comune": "Milano",
      "geometry": [
        "gAAAAABqabgJ3Z1vn40grFU8...=="
      ],
      "geometry_type": "encrypted",
      "id": "10263",
      "nome": "Moscova"
    }
  ]
}