Price
POST /api/price
Real estate listing prices.
Example Request
curl --location 'https://ws-osservatorio.realitycs.it/api/price' \
--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 | |
success_if_empty | optional | false | handle response with empty data | boolean | false |
JSON keys in the response:
- discount: Negotiation margin.
- maintenance_status: Maintenance condition.
- price_sqm_avg: Average unit price.
- price_sqm_max: Maximum unit price.
- price_sqm_min: Minimum unit price.
- price_typologies: Property typology.
- rooms: Number of rooms.
Example Response
{
"_metadata": {
"message": "",
"query": {},
"status": 200,
"request_id": "1eb7d444-17a7-4808-83e7-8b6ba3c51637"
},
"items": [
{
"discount": {
"delta": {
"value": 0.0,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 1
},
"value": 8.4
},
"maintenance_status": {
"1": {
"price_10pc": 1954,
"price_20pc": 2483,
"price_50pc": 2916,
"price_80pc": 3335,
"price_90pc": 4111
},
"2": {
"price_10pc": 1611,
"price_20pc": 1931,
"price_50pc": 2361,
"price_80pc": 2753,
"price_90pc": 3305
},
"3": {
"price_10pc": 1238,
"price_20pc": 1600,
"price_50pc": 1968,
"price_80pc": 2326,
"price_90pc": 2781
},
"4": {
"price_10pc": 990,
"price_20pc": 1259,
"price_50pc": 1643,
"price_80pc": 1899,
"price_90pc": 2463
}
},
"price_avg": {
"delta": {
"value": 0.0,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 4
},
"value": 282342
},
"price_max": {
"delta": {
"value": 0.0,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 4
},
"value": 549050
},
"price_min": {
"delta": {
"value": 0.0,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 3
},
"value": 130000
},
"price_sqm_avg": {
"delta": {
"value": 0.76,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 3
},
"value": 2131
},
"price_sqm_elasticity": {
"delta": {
"value": 2.65,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 3
},
"value": -6.238
},
"price_sqm_max": {
"delta": {
"value": 1.35,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 3
},
"value": 3161
},
"price_sqm_min": {
"delta": {
"value": -0.56,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 2
},
"value": 1240
},
"price_sqm_variability": {
"delta": {
"value": -12.77,
"window": "1M"
},
"ranking": {
"of": 7,
"position": 4
},
"value": 4.51
},
"price_typologies": {
"10": {
"price_10pc": 976,
"price_20pc": 1013,
"price_50pc": 1106,
"price_80pc": 1180,
"price_90pc": 1343
},
"11": {
"price_10pc": 752,
"price_20pc": 798,
"price_50pc": 1734,
"price_80pc": 2533,
"price_90pc": 3022
},
"12": {
"price_10pc": 1377,
"price_20pc": 1734,
"price_50pc": 2352,
"price_80pc": 2909,
"price_90pc": 3955
},
"13": {
"price_10pc": 1721,
"price_20pc": 1900,
"price_50pc": 2403,
"price_80pc": 2595,
"price_90pc": 4230
},
"31": {
"price_10pc": 2165,
"price_20pc": 2178,
"price_50pc": 2520,
"price_80pc": 2665,
"price_90pc": 3114
},
"4": {
"price_10pc": 1383,
"price_20pc": 1731,
"price_50pc": 2163,
"price_80pc": 2622,
"price_90pc": 3093
},
"5": {
"price_10pc": 1228,
"price_20pc": 1682,
"price_50pc": 2136,
"price_80pc": 2481,
"price_90pc": 3370
},
"7": {
"price_10pc": 1075,
"price_20pc": 1425,
"price_50pc": 1911,
"price_80pc": 2318,
"price_90pc": 2882
}
},
"rooms": {
"1": {
"price_10pc": 1220,
"price_20pc": 1708,
"price_50pc": 2289,
"price_80pc": 2811,
"price_90pc": 3051
},
"2": {
"price_10pc": 1737,
"price_20pc": 2187,
"price_50pc": 2574,
"price_80pc": 3000,
"price_90pc": 3452
},
"3": {
"price_10pc": 1573,
"price_20pc": 1875,
"price_50pc": 2339,
"price_80pc": 2778,
"price_90pc": 3173
},
"4": {
"price_10pc": 1373,
"price_20pc": 1741,
"price_50pc": 2174,
"price_80pc": 2627,
"price_90pc": 3111
},
"5": {
"price_10pc": 1270,
"price_20pc": 1620,
"price_50pc": 2017,
"price_80pc": 2411,
"price_90pc": 2988
},
"m5": {
"price_10pc": 1067,
"price_20pc": 1478,
"price_50pc": 1951,
"price_80pc": 2372,
"price_90pc": 3082
}
}
}
]
}