Sales

GET /api/report/appraisal/<report_uuid>/sales

Transactions actually closed around the property: the comparable sales, their averages and the trend of the zone.

Example Request

curl --location 'https://insights.immobiliare.it/api/report/appraisal/e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f/sales?show_geo=1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'

Request Fields

Field	Required	Default	Description	Type	Example	Notes
`report_uuid`	yes		UUID of the report, given during the creation	string	`e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f`	Path parameter
`show_geo`	optional	`false`	Adds the `sales_map` layer to the response	any	`?show_geo=1`	Any value enables it

JSON keys in the response:

Averages

average_price: Average price of the closed transactions, in €.
average_unit_price: Average unit price of the closed transactions, in €/m².
average_surface: Average surface of the properties sold, in m².
average_surface_asset_type: Average surface restricted to the typology of the valued property, in m².
new_transactions: Number of transactions closed in the reference period.
new_transactions_asset_type: The same figure restricted to the typology of the valued property.

comparables

sale_month: Month the transaction was closed, in Italian short form such as Mar 2024.
address: Address of the property sold. May be null when it cannot be disclosed.
asset_type: Typology of the property sold, in abbreviated cadastral form such as Ab. civile/econ..
cadastral_category: Cadastral category, such as A2.
consistency: Cadastral consistency of the property, in m².
floor: Floor of the unit. - when not available.
price: Price the property was sold at, in €.
price_sqm: Unit price the property was sold at, in €/m².
lat / lng: Coordinates of the property sold, see the warning below.

Charts

average_price_chart: Historical series of the average unit price, as category and value pairs. category is a <month>-<year> label.
new_transactions_chart: Historical series of the number of transactions, same shape.
average_surface_chart: Distribution of the average surface by cadastral typology, as category and value pairs.

Zone and header

zone.address: Zone the transactions were taken from.
zone.reference_period: Reference period of the data, in Italian.
header: Presentation strings for the page of the report: title, description, caption and the recap of the valued property. email and phone hold the contacts of the agent shown on the report, and may be null.

sales_map

GeoJSON FeatureCollection with one Point per transaction, only returned when show_geo is set.

lat and lng are swapped

In the comparables array the two keys are inverted, exactly as in the Comparables block: lat carries the longitude and lng carries the latitude. The sales_map layer is not affected and follows the GeoJSON convention correctly.

Example Response

Note

The example below is truncated to two transactions, two points per chart and one map feature, the actual response returns the whole series.

{
  "_metadata": {
    "message": "",
    "query": {},
    "status": 200
  },
  "data": {
    "average_price": 256673,
    "average_price_chart": [
      {
        "category": "12-2023",
        "value": 1582
      },
      {
        "category": "3-2024",
        "value": 1618
      }
    ],
    "average_surface": 115,
    "average_surface_asset_type": 0,
    "average_surface_chart": [
      {
        "category": "Abitazioni di tipo civile",
        "value": 100
      }
    ],
    "average_unit_price": 2123,
    "comparables": [
      {
        "address": null,
        "asset_type": "Ab. civile/econ.",
        "cadastral_category": "A2",
        "consistency": 90,
        "floor": "-",
        "lat": 11.0397325,
        "lng": 43.86377748,
        "price": 170000,
        "price_sqm": 1899,
        "sale_month": "Mar 2024"
      },
      {
        "address": "VIA ZELINDO MANNELLI",
        "asset_type": "Ab. civile/econ.",
        "cadastral_category": "A2",
        "consistency": 138,
        "floor": "-",
        "lat": 11.03897485,
        "lng": 43.86455541,
        "price": 250000,
        "price_sqm": 1812,
        "sale_month": "Gen 2024"
      }
    ],
    "header": {
      "address": "Via Adolfo Sironi",
      "asset_type": "Pentalocale",
      "caption": "Immobiliare.it Insights",
      "city": "Prato",
      "description": "Immobili simili venduti nei dintorni dell'immobile analizzato.",
      "email": "agent@example.com",
      "phone": null,
      "surface": 90.0,
      "title": "Compravendite"
    },
    "new_transactions": 12.7,
    "new_transactions_asset_type": 0,
    "new_transactions_chart": [
      {
        "category": "12-2023",
        "value": 7
      },
      {
        "category": "3-2024",
        "value": 16
      }
    ],
    "sales_map": {
      "features": [
        {
          "coordinates": [
            11.0397325,
            43.86377748
          ],
          "markerIconOptions": {
            "iconSize": [
              33,
              33
            ],
            "iconUrl": "https://pdf-generator-dev.realitycs.it/static/images/icone-b2c/color-5/pallino_1.png"
          },
          "properties": {},
          "type": "Point"
        }
      ],
      "type": "FeatureCollection"
    },
    "zone": {
      "address": "Iolo, Casale",
      "reference_period": "4° trimestre del 2024"
    }
  }
}