Skip to content

Sales Price History

POST /api/sales/price/history

Historical time series of sale prices.

Example Request

curl --location 'https://ws-osservatorio.realitycs.it/api/sales/price/history' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
   "ty_zone": "com",
   "id_zone": "100005",
   "window": "1M",
   "contract": 1,
   "year": 2024,
   "month": 12,
   "typology": 4,
   "nation": "IT"
}'

Request Fields

Field Required Default Description Type Example Notes
ty_zone yes Zone type string com
id_zone yes Zone ID string 100005
window yes Time window string 1M
contract yes Contract type number 1
year yes Required year number 2024
month yes Required month number 12
cadastral_typology optional Esatate cadastral typology string A4
nation optional IT Nation code string IT

JSON keys in the response

  • compravendite_price_sqm_avg: Average transaction price.

Example Response

{
    "_metadata": {
        "message": "",
        "query": {},
        "status": 200,
        "request_id": "7cb8255e-c582-43bf-a978-ca15381f7ded"
    },
    "items": [
        {
            "compravendite_price_sqm_avg": [
                {
                    "month": 6,
                    "price_avg": 1453,
                    "year": 2020
                },
                {
                    "month": 9,
                    "price_avg": 1431,
                    "year": 2020
                },
                {
                    "month": 12,
                    "price_avg": 1483,
                    "year": 2020
                },
                {
                    "month": 3,
                    "price_avg": 1482,
                    "year": 2021
                },
                {
                    "month": 6,
                    "price_avg": 1478,
                    "year": 2021
                },
                {
                    "month": 9,
                    "price_avg": 1500,
                    "year": 2021
                },
                {
                    "month": 12,
                    "price_avg": 1514,
                    "year": 2021
                },
                {
                    "month": 3,
                    "price_avg": 1503,
                    "year": 2022
                },
                {
                    "month": 6,
                    "price_avg": 1538,
                    "year": 2022
                },
                {
                    "month": 9,
                    "price_avg": 1512,
                    "year": 2022
                },
                {
                    "month": 12,
                    "price_avg": 1485,
                    "year": 2022
                },
                {
                    "month": 3,
                    "price_avg": 1492,
                    "year": 2023
                },
                {
                    "month": 6,
                    "price_avg": 1469,
                    "year": 2023
                }
            ]
        }
    ]
}