Ads History
POST /api/ads/history
Historical series of listings stock.
Example Request
curl --location 'https://ws-osservatorio.realitycs.it/api/ads/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
- maintenance_status: Number of listings by maintenance condition.
- rooms: Number of listings by room count.
- qt: Number of listings.
Example Response
{
"_metadata": {
"message": "",
"query": {},
"status": 200,
"request_id": "3073e5b2-f19c-4e14-a57a-9e8aea329c7e"
},
"items": [
{
"maintenance_status": {
"1": [
{
"month": 6,
"price_avg": 3607,
"price_avgin": 3697,
"price_avgout": 3305,
"year": 2021
},
{
"month": 9,
"price_avg": 3654,
"price_avgin": 3513,
"price_avgout": 3160,
"year": 2021
},
{
"month": 12,
"price_avg": 3674,
"price_avgin": 3534,
"price_avgout": 3223,
"year": 2021
},
{
"month": 3,
"price_avg": 3703,
"price_avgin": 3610,
"price_avgout": 3546,
"year": 2022
},
{
"month": 6,
"price_avg": 3745,
"price_avgin": 3866,
"price_avgout": 3488,
"year": 2022
},
{
"month": 9,
"price_avg": 3787,
"price_avgin": 3829,
"price_avgout": 3727,
"year": 2022
},
{
"month": 12,
"price_avg": 3727,
"price_avgin": 3678,
"price_avgout": 3489,
"year": 2022
},
{
"month": 3,
"price_avg": 3811,
"price_avgin": 3855,
"price_avgout": 3689,
"year": 2023
},
{
"month": 6,
"price_avg": 3931,
"price_avgin": 3901,
"price_avgout": 3612,
"year": 2023
},
{
"month": 9,
"price_avg": 3852,
"price_avgin": 3826,
"price_avgout": 3536,
"year": 2023
},
{
"month": 12,
"price_avg": 3806,
"price_avgin": 3645,
"price_avgout": 3267,
"year": 2023
},
{
"month": 3,
"price_avg": 3996,
"price_avgin": 4304,
"price_avgout": 3638,
"year": 2024
},
{
"month": 6,
"price_avg": 4003,
"price_avgin": 4182,
"price_avgout": 3918,
"year": 2024
}
],
"2": [
{
"month": 6,
"price_avg": 2929,
"price_avgin": 2867,
"price_avgout": 2856,
"year": 2021
},
{
"month": 9,
"price_avg": 2971,
"price_avgin": 2956,
"price_avgout": 2911,
"year": 2021
},
{
"month": 12,
"price_avg": 2965,
"price_avgin": 2881,
"price_avgout": 2791,
"year": 2021
},
{
"month": 3,
"price_avg": 2990,
"price_avgin": 2907,
"price_avgout": 2975,
"year": 2022
},
{
"month": 6,
"price_avg": 2989,
"price_avgin": 2913,
"price_avgout": 2861,
"year": 2022
},
{
"month": 9,
"price_avg": 3025,
"price_avgin": 2987,
"price_avgout": 2891,
"year": 2022
},
{
"month": 12,
"price_avg": 3022,
"price_avgin": 2919,
"price_avgout": 2835,
"year": 2022
},
{
"month": 3,
"price_avg": 3043,
"price_avgin": 2967,
"price_avgout": 2867,
"year": 2023
},
{
"month": 6,
"price_avg": 3055,
"price_avgin": 3018,
"price_avgout": 2949,
"year": 2023
},
{
"month": 9,
"price_avg": 3089,
"price_avgin": 3084,
"price_avgout": 3017,
"year": 2023
},
{
"month": 12,
"price_avg": 3070,
"price_avgin": 3011,
"price_avgout": 2938,
"year": 2023
},
{
"month": 3,
"price_avg": 3103,
"price_avgin": 3115,
"price_avgout": 2919,
"year": 2024
},
{
"month": 6,
"price_avg": 3158,
"price_avgin": 3182,
"price_avgout": 3171,
"year": 2024
}
],
"3": [
{
"month": 6,
"price_avg": 2308,
"price_avgin": 2268,
"price_avgout": 2283,
"year": 2021
},
{
"month": 9,
"price_avg": 2328,
"price_avgin": 2315,
"price_avgout": 2281,
"year": 2021
},
{
"month": 12,
"price_avg": 2329,
"price_avgin": 2262,
"price_avgout": 2258,
"year": 2021
},
{
"month": 3,
"price_avg": 2346,
"price_avgin": 2323,
"price_avgout": 2350,
"year": 2022
},
{
"month": 6,
"price_avg": 2347,
"price_avgin": 2285,
"price_avgout": 2321,
"year": 2022
},
{
"month": 9,
"price_avg": 2349,
"price_avgin": 2284,
"price_avgout": 2261,
"year": 2022
},
{
"month": 12,
"price_avg": 2355,
"price_avgin": 2305,
"price_avgout": 2230,
"year": 2022
},
{
"month": 3,
"price_avg": 2379,
"price_avgin": 2320,
"price_avgout": 2310,
"year": 2023
},
{
"month": 6,
"price_avg": 2374,
"price_avgin": 2329,
"price_avgout": 2419,
"year": 2023
},
{
"month": 9,
"price_avg": 2376,
"price_avgin": 2332,
"price_avgout": 2302,
"year": 2023
},
{
"month": 12,
"price_avg": 2370,
"price_avgin": 2344,
"price_avgout": 2349,
"year": 2023
},
{
"month": 3,
"price_avg": 2388,
"price_avgin": 2423,
"price_avgout": 2330,
"year": 2024
},
{
"month": 6,
"price_avg": 2386,
"price_avgin": 2382,
"price_avgout": 2372,
"year": 2024
}
],
"4": [
{
"month": 6,
"price_avg": 1706,
"price_avgin": 1628,
"price_avgout": 1764,
"year": 2021
},
{
"month": 9,
"price_avg": 1723,
"price_avgin": 1728,
"price_avgout": 1739,
"year": 2021
},
{
"month": 12,
"price_avg": 1707,
"price_avgin": 1645,
"price_avgout": 1689,
"year": 2021
},
{
"month": 3,
"price_avg": 1709,
"price_avgin": 1712,
"price_avgout": 1717,
"year": 2022
},
{
"month": 6,
"price_avg": 1716,
"price_avgin": 1685,
"price_avgout": 1812,
"year": 2022
},
{
"month": 9,
"price_avg": 1717,
"price_avgin": 1681,
"price_avgout": 1721,
"year": 2022
},
{
"month": 12,
"price_avg": 1747,
"price_avgin": 1733,
"price_avgout": 1867,
"year": 2022
},
{
"month": 3,
"price_avg": 1741,
"price_avgin": 1715,
"price_avgout": 1738,
"year": 2023
},
{
"month": 6,
"price_avg": 1722,
"price_avgin": 1684,
"price_avgout": 1910,
"year": 2023
},
{
"month": 9,
"price_avg": 1714,
"price_avgin": 1724,
"price_avgout": 1846,
"year": 2023
},
{
"month": 12,
"price_avg": 1715,
"price_avgin": 1742,
"price_avgout": 1740,
"year": 2023
},
{
"month": 3,
"price_avg": 1728,
"price_avgin": 1744,
"price_avgout": 1815,
"year": 2024
},
{
"month": 6,
"price_avg": 1716,
"price_avgin": 1712,
"price_avgout": 1824,
"year": 2024
}
]
},
"price_sqm_avg": [
{
"month": 6,
"price_avg": 2548,
"price_avgin": 2482,
"price_avgout": 2511,
"year": 2021
},
{
"month": 9,
"price_avg": 2571,
"price_avgin": 2529,
"price_avgout": 2489,
"year": 2021
},
{
"month": 12,
"price_avg": 2558,
"price_avgin": 2445,
"price_avgout": 2438,
"year": 2021
},
{
"month": 3,
"price_avg": 2561,
"price_avgin": 2481,
"price_avgout": 2552,
"year": 2022
},
{
"month": 6,
"price_avg": 2564,
"price_avgin": 2496,
"price_avgout": 2506,
"year": 2022
},
{
"month": 9,
"price_avg": 2591,
"price_avgin": 2542,
"price_avgout": 2486,
"year": 2022
},
{
"month": 12,
"price_avg": 2582,
"price_avgin": 2479,
"price_avgout": 2460,
"year": 2022
},
{
"month": 3,
"price_avg": 2592,
"price_avgin": 2507,
"price_avgout": 2514,
"year": 2023
},
{
"month": 6,
"price_avg": 2592,
"price_avgin": 2529,
"price_avgout": 2579,
"year": 2023
},
{
"month": 9,
"price_avg": 2611,
"price_avgin": 2587,
"price_avgout": 2524,
"year": 2023
},
{
"month": 12,
"price_avg": 2600,
"price_avgin": 2542,
"price_avgout": 2496,
"year": 2023
},
{
"month": 3,
"price_avg": 2673,
"price_avgin": 2770,
"price_avgout": 2518,
"year": 2024
},
{
"month": 6,
"price_avg": 2693,
"price_avgin": 2664,
"price_avgout": 2640,
"year": 2024
}
],
"rooms": {
"1": [
{
"month": 6,
"price_avg": 2864,
"price_avgin": 2798,
"price_avgout": 2928,
"year": 2021
},
{
"month": 9,
"price_avg": 2890,
"price_avgin": 2854,
"price_avgout": 2923,
"year": 2021
},
{
"month": 12,
"price_avg": 2835,
"price_avgin": 2677,
"price_avgout": 2828,
"year": 2021
},
{
"month": 3,
"price_avg": 2793,
"price_avgin": 2668,
"price_avgout": 2917,
"year": 2022
},
{
"month": 6,
"price_avg": 2832,
"price_avgin": 2915,
"price_avgout": 2944,
"year": 2022
},
{
"month": 9,
"price_avg": 2883,
"price_avgin": 2947,
"price_avgout": 2690,
"year": 2022
},
{
"month": 12,
"price_avg": 3026,
"price_avgin": 3087,
"price_avgout": 2896,
"year": 2022
},
{
"month": 3,
"price_avg": 3011,
"price_avgin": 2913,
"price_avgout": 2932,
"year": 2023
},
{
"month": 6,
"price_avg": 3112,
"price_avgin": 3247,
"price_avgout": 3030,
"year": 2023
},
{
"month": 9,
"price_avg": 3058,
"price_avgin": 2867,
"price_avgout": 3186,
"year": 2023
},
{
"month": 12,
"price_avg": 2950,
"price_avgin": 2723,
"price_avgout": 2627,
"year": 2023
},
{
"month": 3,
"price_avg": 3020,
"price_avgin": 3071,
"price_avgout": 3087,
"year": 2024
},
{
"month": 6,
"price_avg": 3082,
"price_avgin": 3191,
"price_avgout": 2952,
"year": 2024
}
],
"2": [
{
"month": 6,
"price_avg": 2822,
"price_avgin": 2735,
"price_avgout": 2783,
"year": 2021
},
{
"month": 9,
"price_avg": 2866,
"price_avgin": 2845,
"price_avgout": 2768,
"year": 2021
},
{
"month": 12,
"price_avg": 2835,
"price_avgin": 2714,
"price_avgout": 2749,
"year": 2021
},
{
"month": 3,
"price_avg": 2845,
"price_avgin": 2783,
"price_avgout": 2855,
"year": 2022
},
{
"month": 6,
"price_avg": 2856,
"price_avgin": 2806,
"price_avgout": 2813,
"year": 2022
},
{
"month": 9,
"price_avg": 2911,
"price_avgin": 2922,
"price_avgout": 2886,
"year": 2022
},
{
"month": 12,
"price_avg": 2891,
"price_avgin": 2848,
"price_avgout": 2750,
"year": 2022
},
{
"month": 3,
"price_avg": 2929,
"price_avgin": 2887,
"price_avgout": 2919,
"year": 2023
},
{
"month": 6,
"price_avg": 2966,
"price_avgin": 2945,
"price_avgout": 2904,
"year": 2023
},
{
"month": 9,
"price_avg": 2996,
"price_avgin": 3020,
"price_avgout": 2952,
"year": 2023
},
{
"month": 12,
"price_avg": 2999,
"price_avgin": 2942,
"price_avgout": 2988,
"year": 2023
},
{
"month": 3,
"price_avg": 3112,
"price_avgin": 3248,
"price_avgout": 2931,
"year": 2024
},
{
"month": 6,
"price_avg": 3143,
"price_avgin": 3088,
"price_avgout": 3166,
"year": 2024
}
],
"3": [
{
"month": 6,
"price_avg": 2593,
"price_avgin": 2540,
"price_avgout": 2617,
"year": 2021
},
{
"month": 9,
"price_avg": 2619,
"price_avgin": 2595,
"price_avgout": 2540,
"year": 2021
},
{
"month": 12,
"price_avg": 2595,
"price_avgin": 2439,
"price_avgout": 2507,
"year": 2021
},
{
"month": 3,
"price_avg": 2600,
"price_avgin": 2514,
"price_avgout": 2600,
"year": 2022
},
{
"month": 6,
"price_avg": 2617,
"price_avgin": 2527,
"price_avgout": 2571,
"year": 2022
},
{
"month": 9,
"price_avg": 2627,
"price_avgin": 2529,
"price_avgout": 2530,
"year": 2022
},
{
"month": 12,
"price_avg": 2623,
"price_avgin": 2521,
"price_avgout": 2532,
"year": 2022
},
{
"month": 3,
"price_avg": 2639,
"price_avgin": 2530,
"price_avgout": 2480,
"year": 2023
},
{
"month": 6,
"price_avg": 2659,
"price_avgin": 2593,
"price_avgout": 2681,
"year": 2023
},
{
"month": 9,
"price_avg": 2664,
"price_avgin": 2628,
"price_avgout": 2505,
"year": 2023
},
{
"month": 12,
"price_avg": 2671,
"price_avgin": 2634,
"price_avgout": 2541,
"year": 2023
},
{
"month": 3,
"price_avg": 2769,
"price_avgin": 2894,
"price_avgout": 2610,
"year": 2024
},
{
"month": 6,
"price_avg": 2781,
"price_avgin": 2717,
"price_avgout": 2625,
"year": 2024
}
],
"4": [
{
"month": 6,
"price_avg": 2357,
"price_avgin": 2335,
"price_avgout": 2303,
"year": 2021
},
{
"month": 9,
"price_avg": 2354,
"price_avgin": 2318,
"price_avgout": 2318,
"year": 2021
},
{
"month": 12,
"price_avg": 2355,
"price_avgin": 2305,
"price_avgout": 2252,
"year": 2021
},
{
"month": 3,
"price_avg": 2354,
"price_avgin": 2281,
"price_avgout": 2321,
"year": 2022
},
{
"month": 6,
"price_avg": 2360,
"price_avgin": 2344,
"price_avgout": 2270,
"year": 2022
},
{
"month": 9,
"price_avg": 2374,
"price_avgin": 2359,
"price_avgout": 2244,
"year": 2022
},
{
"month": 12,
"price_avg": 2400,
"price_avgin": 2353,
"price_avgout": 2267,
"year": 2022
},
{
"month": 3,
"price_avg": 2397,
"price_avgin": 2324,
"price_avgout": 2288,
"year": 2023
},
{
"month": 6,
"price_avg": 2395,
"price_avgin": 2337,
"price_avgout": 2372,
"year": 2023
},
{
"month": 9,
"price_avg": 2400,
"price_avgin": 2332,
"price_avgout": 2349,
"year": 2023
},
{
"month": 12,
"price_avg": 2389,
"price_avgin": 2342,
"price_avgout": 2310,
"year": 2023
},
{
"month": 3,
"price_avg": 2452,
"price_avgin": 2527,
"price_avgout": 2320,
"year": 2024
},
{
"month": 6,
"price_avg": 2466,
"price_avgin": 2467,
"price_avgout": 2402,
"year": 2024
}
],
"5": [
{
"month": 6,
"price_avg": 2377,
"price_avgin": 2326,
"price_avgout": 2306,
"year": 2021
},
{
"month": 9,
"price_avg": 2396,
"price_avgin": 2344,
"price_avgout": 2226,
"year": 2021
},
{
"month": 12,
"price_avg": 2410,
"price_avgin": 2347,
"price_avgout": 2244,
"year": 2021
},
{
"month": 3,
"price_avg": 2427,
"price_avgin": 2367,
"price_avgout": 2361,
"year": 2022
},
{
"month": 6,
"price_avg": 2422,
"price_avgin": 2311,
"price_avgout": 2367,
"year": 2022
},
{
"month": 9,
"price_avg": 2444,
"price_avgin": 2340,
"price_avgout": 2320,
"year": 2022
},
{
"month": 12,
"price_avg": 2412,
"price_avgin": 2228,
"price_avgout": 2244,
"year": 2022
},
{
"month": 3,
"price_avg": 2364,
"price_avgin": 2201,
"price_avgout": 2350,
"year": 2023
},
{
"month": 6,
"price_avg": 2333,
"price_avgin": 2231,
"price_avgout": 2301,
"year": 2023
},
{
"month": 9,
"price_avg": 2381,
"price_avgin": 2338,
"price_avgout": 2208,
"year": 2023
},
{
"month": 12,
"price_avg": 2358,
"price_avgin": 2275,
"price_avgout": 2240,
"year": 2023
},
{
"month": 3,
"price_avg": 2382,
"price_avgin": 2414,
"price_avgout": 2149,
"year": 2024
},
{
"month": 6,
"price_avg": 2403,
"price_avgin": 2321,
"price_avgout": 2249,
"year": 2024
}
],
"m5": [
{
"month": 6,
"price_avg": 2509,
"price_avgin": 2351,
"price_avgout": 2393,
"year": 2021
},
{
"month": 9,
"price_avg": 2519,
"price_avgin": 2373,
"price_avgout": 2317,
"year": 2021
},
{
"month": 12,
"price_avg": 2535,
"price_avgin": 2389,
"price_avgout": 2365,
"year": 2021
},
{
"month": 3,
"price_avg": 2543,
"price_avgin": 2470,
"price_avgout": 2482,
"year": 2022
},
{
"month": 6,
"price_avg": 2521,
"price_avgin": 2419,
"price_avgout": 2392,
"year": 2022
},
{
"month": 9,
"price_avg": 2568,
"price_avgin": 2482,
"price_avgout": 2423,
"year": 2022
},
{
"month": 12,
"price_avg": 2527,
"price_avgin": 2338,
"price_avgout": 2415,
"year": 2022
},
{
"month": 3,
"price_avg": 2564,
"price_avgin": 2508,
"price_avgout": 2471,
"year": 2023
},
{
"month": 6,
"price_avg": 2534,
"price_avgin": 2450,
"price_avgout": 2563,
"year": 2023
},
{
"month": 9,
"price_avg": 2540,
"price_avgin": 2521,
"price_avgout": 2538,
"year": 2023
},
{
"month": 12,
"price_avg": 2523,
"price_avgin": 2482,
"price_avgout": 2415,
"year": 2023
},
{
"month": 3,
"price_avg": 2533,
"price_avgin": 2581,
"price_avgout": 2446,
"year": 2024
},
{
"month": 6,
"price_avg": 2552,
"price_avgin": 2541,
"price_avgout": 2604,
"year": 2024
}
]
}
}
]
}