Search Data History
POST /api/search-data/history
Historical time series of market demand.
Example Request
curl --location 'https://ws-osservatorio.realitycs.it/api/search-data/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 | ||
typology | optional | Esatate typology | number | 4 | ||
nation | optional | IT | Nation code | string | IT |
JSON keys in the response
- conversion_rate: Conversion trend.
- maintenance_status: Conversion trend by maintenance condition.
- rooms: Conversion trend by room count.
Example Response
{
"_metadata": {
"message": "",
"query": {},
"status": 200,
"request_id": "2a29a622-141b-455d-8eee-da2098c73721"
},
"items": [
{
"conversion_rate": [
{
"month": 6,
"value": 1.4,
"year": 2020
},
{
"month": 9,
"value": 1.3,
"year": 2020
},
{
"month": 12,
"value": 1.2,
"year": 2020
},
{
"month": 3,
"value": 1.6,
"year": 2021
},
{
"month": 6,
"value": 1.5,
"year": 2021
},
{
"month": 9,
"value": 1.4,
"year": 2021
},
{
"month": 12,
"value": 1.5,
"year": 2021
},
{
"month": 3,
"value": 1.6,
"year": 2022
},
{
"month": 6,
"value": 1.6,
"year": 2022
},
{
"month": 9,
"value": 1.5,
"year": 2022
},
{
"month": 12,
"value": 1.5,
"year": 2022
},
{
"month": 3,
"value": 1.4,
"year": 2023
},
{
"month": 6,
"value": 1.3,
"year": 2023
}
],
"maintenance_status": {
"1": [
{
"month": 6,
"value": 1.2,
"year": 2020
},
{
"month": 9,
"value": 0.9,
"year": 2020
},
{
"month": 12,
"value": 0.9,
"year": 2020
},
{
"month": 3,
"value": 1.2,
"year": 2021
},
{
"month": 6,
"value": 1.1,
"year": 2021
},
{
"month": 9,
"value": 1,
"year": 2021
},
{
"month": 12,
"value": 1.1,
"year": 2021
},
{
"month": 3,
"value": 1.2,
"year": 2022
},
{
"month": 6,
"value": 1.2,
"year": 2022
},
{
"month": 9,
"value": 1,
"year": 2022
},
{
"month": 12,
"value": 1,
"year": 2022
},
{
"month": 3,
"value": 1,
"year": 2023
},
{
"month": 6,
"value": 1,
"year": 2023
}
],
"2": [
{
"month": 6,
"value": 1.5,
"year": 2020
},
{
"month": 9,
"value": 1.3,
"year": 2020
},
{
"month": 12,
"value": 1.3,
"year": 2020
},
{
"month": 3,
"value": 1.7,
"year": 2021
},
{
"month": 6,
"value": 1.6,
"year": 2021
},
{
"month": 9,
"value": 1.4,
"year": 2021
},
{
"month": 12,
"value": 1.6,
"year": 2021
},
{
"month": 3,
"value": 1.7,
"year": 2022
},
{
"month": 6,
"value": 1.8,
"year": 2022
},
{
"month": 9,
"value": 1.7,
"year": 2022
},
{
"month": 12,
"value": 1.6,
"year": 2022
},
{
"month": 3,
"value": 1.6,
"year": 2023
},
{
"month": 6,
"value": 1.4,
"year": 2023
}
],
"3": [
{
"month": 6,
"value": 1.4,
"year": 2020
},
{
"month": 9,
"value": 1.3,
"year": 2020
},
{
"month": 12,
"value": 1.3,
"year": 2020
},
{
"month": 3,
"value": 1.7,
"year": 2021
},
{
"month": 6,
"value": 1.5,
"year": 2021
},
{
"month": 9,
"value": 1.4,
"year": 2021
},
{
"month": 12,
"value": 1.5,
"year": 2021
},
{
"month": 3,
"value": 1.6,
"year": 2022
},
{
"month": 6,
"value": 1.6,
"year": 2022
},
{
"month": 9,
"value": 1.5,
"year": 2022
},
{
"month": 12,
"value": 1.5,
"year": 2022
},
{
"month": 3,
"value": 1.4,
"year": 2023
},
{
"month": 6,
"value": 1.3,
"year": 2023
}
],
"4": [
{
"month": 6,
"value": 1.4,
"year": 2020
},
{
"month": 9,
"value": 1.3,
"year": 2020
},
{
"month": 12,
"value": 1.3,
"year": 2020
},
{
"month": 3,
"value": 1.6,
"year": 2021
},
{
"month": 6,
"value": 1.5,
"year": 2021
},
{
"month": 9,
"value": 1.3,
"year": 2021
},
{
"month": 12,
"value": 1.3,
"year": 2021
},
{
"month": 3,
"value": 1.4,
"year": 2022
},
{
"month": 6,
"value": 1.4,
"year": 2022
},
{
"month": 9,
"value": 1.4,
"year": 2022
},
{
"month": 12,
"value": 1.3,
"year": 2022
},
{
"month": 3,
"value": 1.3,
"year": 2023
},
{
"month": 6,
"value": 1.2,
"year": 2023
}
]
},
"pc_rooms": [
{
"1": {
"pc-raw": 2.28,
"qt-raw": 194
},
"2": {
"pc-raw": 15.83,
"qt-raw": 1347
},
"3": {
"pc-raw": 43.53,
"qt-raw": 3705
},
"4": {
"pc-raw": 23.8,
"qt-raw": 2026
},
"5": {
"pc-raw": 14.55,
"qt-raw": 1238
},
"m5": {
"pc-raw": 0.01,
"qt-raw": 1
},
"month": 6,
"qt-minrooms": 8511,
"qt-raw": 31616,
"year": 2020
},
{
"1": {
"pc-raw": 2.41,
"qt-raw": 297
},
"2": {
"pc-raw": 16.89,
"qt-raw": 2079
},
"3": {
"pc-raw": 43.86,
"qt-raw": 5399
},
"4": {
"pc-raw": 23.04,
"qt-raw": 2836
},
"5": {
"pc-raw": 13.56,
"qt-raw": 1669
},
"m5": {
"pc-raw": 0.24,
"qt-raw": 29
},
"month": 9,
"qt-minrooms": 12311,
"qt-raw": 47676,
"year": 2020
},
{
"1": {
"pc-raw": 2.22,
"qt-raw": 313
},
"2": {
"pc-raw": 16.63,
"qt-raw": 2342
},
"3": {
"pc-raw": 42.11,
"qt-raw": 5931
},
"4": {
"pc-raw": 24.08,
"qt-raw": 3392
},
"5": {
"pc-raw": 14.64,
"qt-raw": 2062
},
"m5": {
"pc-raw": 0.33,
"qt-raw": 46
},
"month": 12,
"qt-minrooms": 14087,
"qt-raw": 53684,
"year": 2020
},
{
"1": {
"pc-raw": 2.09,
"qt-raw": 422
},
"2": {
"pc-raw": 16.48,
"qt-raw": 3327
},
"3": {
"pc-raw": 42.44,
"qt-raw": 8569
},
"4": {
"pc-raw": 25.14,
"qt-raw": 5075
},
"5": {
"pc-raw": 13.55,
"qt-raw": 2736
},
"m5": {
"pc-raw": 0.3,
"qt-raw": 60
},
"month": 3,
"qt-minrooms": 20190,
"qt-raw": 78583,
"year": 2021
},
{
"1": {
"pc-raw": 2.19,
"qt-raw": 336
},
"2": {
"pc-raw": 16.71,
"qt-raw": 2569
},
"3": {
"pc-raw": 45.43,
"qt-raw": 6985
},
"4": {
"pc-raw": 23.69,
"qt-raw": 3642
},
"5": {
"pc-raw": 11.74,
"qt-raw": 1805
},
"m5": {
"pc-raw": 0.24,
"qt-raw": 37
},
"month": 6,
"qt-minrooms": 15374,
"qt-raw": 62979,
"year": 2021
},
{
"1": {
"pc-raw": 1.92,
"qt-raw": 221
},
"2": {
"pc-raw": 19.52,
"qt-raw": 2245
},
"3": {
"pc-raw": 44.96,
"qt-raw": 5170
},
"4": {
"pc-raw": 22.58,
"qt-raw": 2597
},
"5": {
"pc-raw": 10.92,
"qt-raw": 1256
},
"m5": {
"pc-raw": 0.1,
"qt-raw": 11
},
"month": 9,
"qt-minrooms": 11500,
"qt-raw": 45320,
"year": 2021
},
{
"1": {
"pc-raw": 2.56,
"qt-raw": 415
},
"2": {
"pc-raw": 19.91,
"qt-raw": 3221
},
"3": {
"pc-raw": 44.84,
"qt-raw": 7256
},
"4": {
"pc-raw": 22.01,
"qt-raw": 3562
},
"5": {
"pc-raw": 10.55,
"qt-raw": 1707
},
"m5": {
"pc-raw": 0.12,
"qt-raw": 20
},
"month": 12,
"qt-minrooms": 16181,
"qt-raw": 57294,
"year": 2021
},
{
"1": {
"pc-raw": 2.59,
"qt-raw": 498
},
"2": {
"pc-raw": 19.87,
"qt-raw": 3816
},
"3": {
"pc-raw": 45.3,
"qt-raw": 8700
},
"4": {
"pc-raw": 22.72,
"qt-raw": 4363
},
"5": {
"pc-raw": 9.35,
"qt-raw": 1796
},
"m5": {
"pc-raw": 0.16,
"qt-raw": 31
},
"month": 3,
"qt-minrooms": 19205,
"qt-raw": 68994,
"year": 2022
},
{
"1": {
"pc-raw": 2.8,
"qt-raw": 470
},
"2": {
"pc-raw": 20.29,
"qt-raw": 3411
},
"3": {
"pc-raw": 45.83,
"qt-raw": 7705
},
"4": {
"pc-raw": 20.97,
"qt-raw": 3526
},
"5": {
"pc-raw": 10.01,
"qt-raw": 1683
},
"m5": {
"pc-raw": 0.1,
"qt-raw": 17
},
"month": 6,
"qt-minrooms": 16812,
"qt-raw": 63377,
"year": 2022
},
{
"1": {
"pc-raw": 3.08,
"qt-raw": 430
},
"2": {
"pc-raw": 22.22,
"qt-raw": 3107
},
"3": {
"pc-raw": 45.53,
"qt-raw": 6366
},
"4": {
"pc-raw": 20.75,
"qt-raw": 2901
},
"5": {
"pc-raw": 8.28,
"qt-raw": 1157
},
"m5": {
"pc-raw": 0.14,
"qt-raw": 20
},
"month": 9,
"qt-minrooms": 13982,
"qt-raw": 54601,
"year": 2022
},
{
"1": {
"pc-raw": 4.67,
"qt-raw": 760
},
"2": {
"pc-raw": 22.87,
"qt-raw": 3719
},
"3": {
"pc-raw": 44.99,
"qt-raw": 7316
},
"4": {
"pc-raw": 18.88,
"qt-raw": 3070
},
"5": {
"pc-raw": 8.49,
"qt-raw": 1380
},
"m5": {
"pc-raw": 0.1,
"qt-raw": 17
},
"month": 12,
"qt-minrooms": 16262,
"qt-raw": 65068,
"year": 2022
},
{
"1": {
"pc-raw": 3.26,
"qt-raw": 648
},
"2": {
"pc-raw": 22.99,
"qt-raw": 4567
},
"3": {
"pc-raw": 44.24,
"qt-raw": 8789
},
"4": {
"pc-raw": 21.44,
"qt-raw": 4260
},
"5": {
"pc-raw": 7.96,
"qt-raw": 1581
},
"m5": {
"pc-raw": 0.1,
"qt-raw": 20
},
"month": 3,
"qt-minrooms": 19867,
"qt-raw": 82773,
"year": 2023
},
{
"1": {
"pc-raw": 3.22,
"qt-raw": 507
},
"2": {
"pc-raw": 23.13,
"qt-raw": 3643
},
"3": {
"pc-raw": 43.94,
"qt-raw": 6922
},
"4": {
"pc-raw": 20.7,
"qt-raw": 3261
},
"5": {
"pc-raw": 8.84,
"qt-raw": 1392
},
"m5": {
"pc-raw": 0.17,
"qt-raw": 27
},
"month": 6,
"qt-minrooms": 15752,
"qt-raw": 69963,
"year": 2023
}
],
"price_sqm_search_avg": [
{
"month": 6,
"value": 2507.58,
"year": 2020
},
{
"month": 9,
"value": 2530.71,
"year": 2020
},
{
"month": 12,
"value": 2564.25,
"year": 2020
},
{
"month": 3,
"value": 2621.49,
"year": 2021
},
{
"month": 6,
"value": 2687.06,
"year": 2021
},
{
"month": 9,
"value": 2724.45,
"year": 2021
},
{
"month": 12,
"value": 2722.07,
"year": 2021
},
{
"month": 3,
"value": 2811.12,
"year": 2022
},
{
"month": 6,
"value": 2749.52,
"year": 2022
},
{
"month": 9,
"value": 2741.93,
"year": 2022
},
{
"month": 12,
"value": 2835.15,
"year": 2022
},
{
"month": 3,
"value": 2752.53,
"year": 2023
},
{
"month": 6,
"value": 2722.16,
"year": 2023
}
],
"res": [
{
"month": 6,
"pc-1floor": 15.35,
"pc-1typology": 49.35,
"pc-garden": 15.51,
"pc-minrooms": 16.33,
"pc-status": 16.33,
"pc-terrace": 1.62,
"qt-raw": 31616,
"year": 2020
},
{
"month": 9,
"pc-1floor": 15.37,
"pc-1typology": 48.11,
"pc-garden": 15.11,
"pc-minrooms": 16.47,
"pc-status": 16.47,
"pc-terrace": 14.38,
"qt-raw": 47676,
"year": 2020
},
{
"month": 12,
"pc-1floor": 16.44,
"pc-1typology": 37.77,
"pc-garden": 11.94,
"pc-minrooms": 16.76,
"pc-status": 16.76,
"pc-terrace": 13.03,
"qt-raw": 53684,
"year": 2020
},
{
"month": 3,
"pc-1floor": 16.27,
"pc-1typology": 35.39,
"pc-garden": 10.93,
"pc-minrooms": 14.54,
"pc-status": 14.54,
"pc-terrace": 11.31,
"qt-raw": 78583,
"year": 2021
},
{
"month": 6,
"pc-1floor": 15.99,
"pc-1typology": 33.35,
"pc-garden": 13.04,
"pc-minrooms": 12.91,
"pc-status": 12.91,
"pc-terrace": 11,
"qt-raw": 62979,
"year": 2021
},
{
"month": 9,
"pc-1floor": 16.9,
"pc-1typology": 30.57,
"pc-garden": 12.55,
"pc-minrooms": 13.25,
"pc-status": 13.25,
"pc-terrace": 11.57,
"qt-raw": 45320,
"year": 2021
},
{
"month": 12,
"pc-1floor": 18.5,
"pc-1typology": 28.93,
"pc-garden": 13.18,
"pc-minrooms": 15.2,
"pc-status": 15.2,
"pc-terrace": 11.63,
"qt-raw": 57294,
"year": 2021
},
{
"month": 3,
"pc-1floor": 18.96,
"pc-1typology": 28.4,
"pc-garden": 12.83,
"pc-minrooms": 15.58,
"pc-status": 15.58,
"pc-terrace": 10.69,
"qt-raw": 68994,
"year": 2022
},
{
"month": 6,
"pc-1floor": 17.93,
"pc-1typology": 29.59,
"pc-garden": 13.69,
"pc-minrooms": 14.32,
"pc-status": 14.32,
"pc-terrace": 10.62,
"qt-raw": 63377,
"year": 2022
},
{
"month": 9,
"pc-1floor": 17.4,
"pc-1typology": 30.22,
"pc-garden": 13.3,
"pc-minrooms": 13.86,
"pc-status": 13.86,
"pc-terrace": 10.07,
"qt-raw": 54601,
"year": 2022
},
{
"month": 12,
"pc-1floor": 17.88,
"pc-1typology": 26.59,
"pc-garden": 9.47,
"pc-minrooms": 13.43,
"pc-status": 13.43,
"pc-terrace": 8.12,
"qt-raw": 65068,
"year": 2022
},
{
"month": 3,
"pc-1floor": 17.4,
"pc-1typology": 25.3,
"pc-garden": 8.81,
"pc-minrooms": 13.44,
"pc-status": 13.44,
"pc-terrace": 7.59,
"qt-raw": 82773,
"year": 2023
},
{
"month": 6,
"pc-1floor": 16.57,
"pc-1typology": 25.77,
"pc-garden": 10.15,
"pc-minrooms": 12.78,
"pc-status": 12.78,
"pc-terrace": 8.16,
"qt-raw": 69963,
"year": 2023
}
],
"rooms": {
"1": [
{
"month": 6,
"value": 1.1,
"year": 2020
},
{
"month": 9,
"value": 1,
"year": 2020
},
{
"month": 12,
"value": 1.2,
"year": 2020
},
{
"month": 3,
"value": 1.4,
"year": 2021
},
{
"month": 6,
"value": 1.1,
"year": 2021
},
{
"month": 9,
"value": 1.1,
"year": 2021
},
{
"month": 12,
"value": 1.3,
"year": 2021
},
{
"month": 3,
"value": 1.2,
"year": 2022
},
{
"month": 6,
"value": 1.2,
"year": 2022
},
{
"month": 9,
"value": 1.2,
"year": 2022
},
{
"month": 12,
"value": 1.4,
"year": 2022
},
{
"month": 3,
"value": 1.4,
"year": 2023
},
{
"month": 6,
"value": 1.3,
"year": 2023
}
],
"2": [
{
"month": 6,
"value": 1.4,
"year": 2020
},
{
"month": 9,
"value": 1.3,
"year": 2020
},
{
"month": 12,
"value": 1.2,
"year": 2020
},
{
"month": 3,
"value": 1.5,
"year": 2021
},
{
"month": 6,
"value": 1.4,
"year": 2021
},
{
"month": 9,
"value": 1.2,
"year": 2021
},
{
"month": 12,
"value": 1.5,
"year": 2021
},
{
"month": 3,
"value": 1.6,
"year": 2022
},
{
"month": 6,
"value": 1.6,
"year": 2022
},
{
"month": 9,
"value": 1.6,
"year": 2022
},
{
"month": 12,
"value": 1.7,
"year": 2022
},
{
"month": 3,
"value": 1.7,
"year": 2023
},
{
"month": 6,
"value": 1.5,
"year": 2023
}
],
"3": [
{
"month": 6,
"value": 1.6,
"year": 2020
},
{
"month": 9,
"value": 1.4,
"year": 2020
},
{
"month": 12,
"value": 1.4,
"year": 2020
},
{
"month": 3,
"value": 1.7,
"year": 2021
},
{
"month": 6,
"value": 1.6,
"year": 2021
},
{
"month": 9,
"value": 1.5,
"year": 2021
},
{
"month": 12,
"value": 1.6,
"year": 2021
},
{
"month": 3,
"value": 1.8,
"year": 2022
},
{
"month": 6,
"value": 1.8,
"year": 2022
},
{
"month": 9,
"value": 1.6,
"year": 2022
},
{
"month": 12,
"value": 1.7,
"year": 2022
},
{
"month": 3,
"value": 1.6,
"year": 2023
},
{
"month": 6,
"value": 1.4,
"year": 2023
}
],
"4": [
{
"month": 6,
"value": 1.5,
"year": 2020
},
{
"month": 9,
"value": 1.3,
"year": 2020
},
{
"month": 12,
"value": 1.3,
"year": 2020
},
{
"month": 3,
"value": 1.7,
"year": 2021
},
{
"month": 6,
"value": 1.6,
"year": 2021
},
{
"month": 9,
"value": 1.5,
"year": 2021
},
{
"month": 12,
"value": 1.5,
"year": 2021
},
{
"month": 3,
"value": 1.7,
"year": 2022
},
{
"month": 6,
"value": 1.7,
"year": 2022
},
{
"month": 9,
"value": 1.6,
"year": 2022
},
{
"month": 12,
"value": 1.5,
"year": 2022
},
{
"month": 3,
"value": 1.5,
"year": 2023
},
{
"month": 6,
"value": 1.3,
"year": 2023
}
],
"5": [
{
"month": 6,
"value": 1.4,
"year": 2020
},
{
"month": 9,
"value": 1.2,
"year": 2020
},
{
"month": 12,
"value": 1.2,
"year": 2020
},
{
"month": 3,
"value": 1.6,
"year": 2021
},
{
"month": 6,
"value": 1.5,
"year": 2021
},
{
"month": 9,
"value": 1.4,
"year": 2021
},
{
"month": 12,
"value": 1.4,
"year": 2021
},
{
"month": 3,
"value": 1.6,
"year": 2022
},
{
"month": 6,
"value": 1.6,
"year": 2022
},
{
"month": 9,
"value": 1.5,
"year": 2022
},
{
"month": 12,
"value": 1.3,
"year": 2022
},
{
"month": 3,
"value": 1.3,
"year": 2023
},
{
"month": 6,
"value": 1.1,
"year": 2023
}
],
"m5": [
{
"month": 6,
"value": 0,
"year": 2020
},
{
"month": 9,
"value": 1,
"year": 2020
},
{
"month": 12,
"value": 0.9,
"year": 2020
},
{
"month": 3,
"value": 1.3,
"year": 2021
},
{
"month": 6,
"value": 1.4,
"year": 2021
},
{
"month": 9,
"value": 1.2,
"year": 2021
},
{
"month": 12,
"value": 1.1,
"year": 2021
},
{
"month": 3,
"value": 1.2,
"year": 2022
},
{
"month": 6,
"value": 1.2,
"year": 2022
},
{
"month": 9,
"value": 1.1,
"year": 2022
},
{
"month": 12,
"value": 1,
"year": 2022
},
{
"month": 3,
"value": 0.9,
"year": 2023
},
{
"month": 6,
"value": 0.9,
"year": 2023
}
]
}
}
]
}