Sales Price
POST /api/sales/price
Real estate transaction prices.
Example Request
curl --location 'https://ws-osservatorio.realitycs.it/api/sales/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 | ||
cadastral_typology | optional | Esatate cadastral typology | string | A4 | ||
nation | optional | IT | Nation code | string | IT | |
success_if_empty | optional | false | handle response with empty data | boolean | false |
JSON keys in the response
- compravendite_price_sqm_avg: Average unit price.
- compravendite_price_sqm_max: Maximum unit price.
- compravendite_price_sqm_min: Minimum unit price.
- compravendite_sales_price_avg: Average price (processed AdE data).
- price_cadastral_typologies: Cadastral category.
Example Response
{
"_metadata": {
"message": "",
"query": {},
"status": 200,
"request_id": "017d6a53-9346-43a8-981e-d8c361202b51"
},
"items": [
{
"compravendite_price_sqm_avg": {
"delta": {
"value": -5.82,
"window": "12M"
},
"ranking": {
"of": 19,
"position": 12
},
"value": 1270
},
"compravendite_price_sqm_max": {
"delta": {
"value": -18.75,
"window": "12M"
},
"ranking": {
"of": 19,
"position": 10
},
"value": 3623
},
"compravendite_price_sqm_min": {
"delta": {
"value": -43.26,
"window": "12M"
},
"ranking": {
"of": 19,
"position": 17
},
"value": 48
},
"compravendite_sales_price_avg": {
"delta": {
"value": -1.02,
"window": "12M"
},
"ranking": {
"of": 19,
"position": 11
},
"value": 130526
},
"price_cadastral_typologies": [
{
"cadastral_typology": "A1",
"price_10pc": 86,
"price_20pc": 919,
"price_50pc": 2054,
"price_80pc": 2426,
"price_90pc": 3162
},
{
"cadastral_typology": "A2",
"price_10pc": 26,
"price_20pc": 760,
"price_50pc": 1435,
"price_80pc": 1985,
"price_90pc": 2473
},
{
"cadastral_typology": "A3",
"price_10pc": 23,
"price_20pc": 647,
"price_50pc": 1237,
"price_80pc": 1719,
"price_90pc": 2099
},
{
"cadastral_typology": "A4",
"price_10pc": 11,
"price_20pc": 190,
"price_50pc": 673,
"price_80pc": 1030,
"price_90pc": 1571
},
{
"cadastral_typology": "A5",
"price_10pc": 27,
"price_20pc": 148,
"price_50pc": 951,
"price_80pc": 1750,
"price_90pc": 2332
},
{
"cadastral_typology": "A6",
"price_10pc": 30,
"price_20pc": 73,
"price_50pc": 183,
"price_80pc": 283,
"price_90pc": 376
},
{
"cadastral_typology": "A7",
"price_10pc": 38,
"price_20pc": 765,
"price_50pc": 1314,
"price_80pc": 1736,
"price_90pc": 2062
},
{
"cadastral_typology": "A8",
"price_10pc": 693,
"price_20pc": 835,
"price_50pc": 1802,
"price_80pc": 2877,
"price_90pc": 3623
},
{
"cadastral_typology": "A9",
"price_10pc": null,
"price_20pc": null,
"price_50pc": null,
"price_80pc": null,
"price_90pc": null
},
{
"cadastral_typology": "A11",
"price_10pc": null,
"price_20pc": null,
"price_50pc": null,
"price_80pc": null,
"price_90pc": null
}
]
}
]
}