Price Forecast
POST /api/price/forecast
Real estate price forecast (future).
Example Request
curl --location 'https://ws-osservatorio.realitycs.it/api/price/forecast' \
--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 | ||
typology | optional | Esatate typology | number | 4 | ||
nation | optional | IT | Nation code | string | IT | |
segmentation | optional | not_segmented | data segmentation selection | string | not_segmented |
JSON keys in the response
Non-segmented case
- price_sqm_avg: Forecast of the average price.
Energy-segmented case
- energy_price_sqm_avg: Forecast of the average price by energy class.
Inside the price_sqm_avg key
- current_value: Starting value used for the prediction calculation.
- month: Prediction month.
- price_95_inf: Lower bound of the 95% price range.
- price_95_sup: Upper bound of the 95% price range.
- price_avg: Single predicted average price within the price range.
- year: Prediction year.
Inside the energy_price_sqm_avg key
- month: Prediction month.
- year: Prediction year.
- energy_high: Object containing forecast data for high energy-class prices.
- energy_low: Object containing forecast data for low energy-class prices.
- energy_medium: Object containing forecast data for medium energy-class prices.
Inside the energy_high, energy_low, and energy_medium objects
- price_95_inf: Lower bound of the 95% price range.
- price_95_sup: Upper bound of the 95% price range.
- price_avg: Single predicted average price within the price range.
- current_value: Starting value used for the prediction calculation.
Example Response
Example with not_segmented option
{
"_metadata": {
"message": "",
"query": {},
"status": 200,
"request_id": "a0c36fdf-ad46-4bd2-a977-52b901cad47d"
},
"items": [
{
"price_sqm_avg": [
{
"current_value": 2349,
"month": 12,
"price_95_inf": 2325,
"price_95_sup": 2383,
"price_avg": 2354,
"year": 2025
},
{
"current_value": 2349,
"month": 3,
"price_95_inf": 2316,
"price_95_sup": 2404,
"price_avg": 2360,
"year": 2026
},
{
"current_value": 2349,
"month": 6,
"price_95_inf": 2306,
"price_95_sup": 2428,
"price_avg": 2367,
"year": 2026
},
{
"current_value": 2349,
"month": 9,
"price_95_inf": 2298,
"price_95_sup": 2450,
"price_avg": 2374,
"year": 2026
},
{
"current_value": 2349,
"month": 12,
"price_95_inf": 2277,
"price_95_sup": 2489,
"price_avg": 2383,
"year": 2026
},
{
"current_value": 2349,
"month": 3,
"price_95_inf": 2241,
"price_95_sup": 2541,
"price_avg": 2391,
"year": 2027
},
{
"current_value": 2349,
"month": 6,
"price_95_inf": 2176,
"price_95_sup": 2624,
"price_avg": 2400,
"year": 2027
},
{
"current_value": 2349,
"month": 9,
"price_95_inf": 2127,
"price_95_sup": 2693,
"price_avg": 2410,
"year": 2027
},
{
"current_value": 2349,
"month": 12,
"price_95_inf": 2084,
"price_95_sup": 2754,
"price_avg": 2419,
"year": 2027
},
{
"current_value": 2349,
"month": 3,
"price_95_inf": 2057,
"price_95_sup": 2803,
"price_avg": 2430,
"year": 2028
},
{
"current_value": 2349,
"month": 6,
"price_95_inf": 2047,
"price_95_sup": 2835,
"price_avg": 2441,
"year": 2028
},
{
"current_value": 2349,
"month": 9,
"price_95_inf": 2057,
"price_95_sup": 2849,
"price_avg": 2453,
"year": 2028
},
{
"current_value": 2349,
"month": 12,
"price_95_inf": 2066,
"price_95_sup": 2866,
"price_avg": 2466,
"year": 2028
},
{
"current_value": 2349,
"month": 3,
"price_95_inf": 2074,
"price_95_sup": 2882,
"price_avg": 2478,
"year": 2029
},
{
"current_value": 2349,
"month": 6,
"price_95_inf": 2084,
"price_95_sup": 2900,
"price_avg": 2492,
"year": 2029
},
{
"current_value": 2349,
"month": 9,
"price_95_inf": 2090,
"price_95_sup": 2916,
"price_avg": 2503,
"year": 2029
},
{
"current_value": 2349,
"month": 12,
"price_95_inf": 2096,
"price_95_sup": 2932,
"price_avg": 2514,
"year": 2029
},
{
"current_value": 2349,
"month": 3,
"price_95_inf": 2103,
"price_95_sup": 2951,
"price_avg": 2527,
"year": 2030
},
{
"current_value": 2349,
"month": 6,
"price_95_inf": 2110,
"price_95_sup": 2968,
"price_avg": 2539,
"year": 2030
},
{
"current_value": 2349,
"month": 9,
"price_95_inf": 2116,
"price_95_sup": 2986,
"price_avg": 2551,
"year": 2030
}
]
}
]
}
Example with energy option
{
"_metadata": {
"message": "",
"query": {},
"status": 200,
"request_id": "a2e15881-811d-4a4a-a7e1-37caef64202c"
},
"items": [
{
"energy_price_sqm_avg": [
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2687,
"price_95_sup": 3217,
"price_avg": 2952
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2199,
"price_95_sup": 2251,
"price_avg": 2225
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2572,
"price_95_sup": 2620,
"price_avg": 2596
},
"month": 12,
"year": 2025
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2683,
"price_95_sup": 3217,
"price_avg": 2950
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2192,
"price_95_sup": 2268,
"price_avg": 2230
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2540,
"price_95_sup": 2644,
"price_avg": 2592
},
"month": 3,
"year": 2026
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2704,
"price_95_sup": 3242,
"price_avg": 2973
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2191,
"price_95_sup": 2277,
"price_avg": 2234
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2533,
"price_95_sup": 2645,
"price_avg": 2589
},
"month": 6,
"year": 2026
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2728,
"price_95_sup": 3272,
"price_avg": 3000
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2194,
"price_95_sup": 2284,
"price_avg": 2239
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2510,
"price_95_sup": 2668,
"price_avg": 2589
},
"month": 9,
"year": 2026
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2749,
"price_95_sup": 3299,
"price_avg": 3024
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2164,
"price_95_sup": 2326,
"price_avg": 2245
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2483,
"price_95_sup": 2699,
"price_avg": 2591
},
"month": 12,
"year": 2026
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2749,
"price_95_sup": 3305,
"price_avg": 3027
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2132,
"price_95_sup": 2368,
"price_avg": 2250
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2427,
"price_95_sup": 2759,
"price_avg": 2593
},
"month": 3,
"year": 2027
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2743,
"price_95_sup": 3305,
"price_avg": 3024
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2099,
"price_95_sup": 2411,
"price_avg": 2255
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2405,
"price_95_sup": 2785,
"price_avg": 2595
},
"month": 6,
"year": 2027
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2792,
"price_95_sup": 3362,
"price_avg": 3077
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2079,
"price_95_sup": 2441,
"price_avg": 2260
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2407,
"price_95_sup": 2787,
"price_avg": 2597
},
"month": 9,
"year": 2027
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2786,
"price_95_sup": 3364,
"price_avg": 3075
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2084,
"price_95_sup": 2446,
"price_avg": 2265
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2409,
"price_95_sup": 2789,
"price_avg": 2599
},
"month": 12,
"year": 2027
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2706,
"price_95_sup": 3500,
"price_avg": 3103
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2046,
"price_95_sup": 2494,
"price_avg": 2270
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2357,
"price_95_sup": 2845,
"price_avg": 2601
},
"month": 3,
"year": 2028
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2719,
"price_95_sup": 3529,
"price_avg": 3124
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2019,
"price_95_sup": 2531,
"price_avg": 2275
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2357,
"price_95_sup": 2849,
"price_avg": 2603
},
"month": 6,
"year": 2028
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2552,
"price_95_sup": 3732,
"price_avg": 3142
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2025,
"price_95_sup": 2537,
"price_avg": 2281
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2356,
"price_95_sup": 2854,
"price_avg": 2605
},
"month": 9,
"year": 2028
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2501,
"price_95_sup": 3815,
"price_avg": 3158
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2026,
"price_95_sup": 2550,
"price_avg": 2288
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2350,
"price_95_sup": 2864,
"price_avg": 2607
},
"month": 12,
"year": 2028
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2471,
"price_95_sup": 3887,
"price_avg": 3179
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2026,
"price_95_sup": 2562,
"price_avg": 2294
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2343,
"price_95_sup": 2875,
"price_avg": 2609
},
"month": 3,
"year": 2029
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2492,
"price_95_sup": 3908,
"price_avg": 3200
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2026,
"price_95_sup": 2574,
"price_avg": 2300
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2341,
"price_95_sup": 2881,
"price_avg": 2611
},
"month": 6,
"year": 2029
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2511,
"price_95_sup": 3927,
"price_avg": 3219
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2030,
"price_95_sup": 2584,
"price_avg": 2307
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2334,
"price_95_sup": 2894,
"price_avg": 2614
},
"month": 9,
"year": 2029
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2528,
"price_95_sup": 3944,
"price_avg": 3236
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2031,
"price_95_sup": 2597,
"price_avg": 2314
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2325,
"price_95_sup": 2909,
"price_avg": 2617
},
"month": 12,
"year": 2029
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2551,
"price_95_sup": 3967,
"price_avg": 3259
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2034,
"price_95_sup": 2608,
"price_avg": 2321
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2310,
"price_95_sup": 2930,
"price_avg": 2620
},
"month": 3,
"year": 2030
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2572,
"price_95_sup": 3988,
"price_avg": 3280
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2033,
"price_95_sup": 2625,
"price_avg": 2329
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2313,
"price_95_sup": 2933,
"price_avg": 2623
},
"month": 6,
"year": 2030
},
{
"energy_high": {
"current_value": 2935,
"price_95_inf": 2591,
"price_95_sup": 4007,
"price_avg": 3299
},
"energy_low": {
"current_value": 2220,
"price_95_inf": 2026,
"price_95_sup": 2646,
"price_avg": 2336
},
"energy_medium": {
"current_value": 2601,
"price_95_inf": 2318,
"price_95_sup": 2938,
"price_avg": 2628
},
"month": 9,
"year": 2030
}
]
}
]
}