Market

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

Market block of the report: prices, supply and demand of the zone, composition of the listings on sale and forecast of the unit price.

Example Request

curl --location 'https://insights.immobiliare.it/api/report/appraisal/e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f/market' \
--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

JSON keys in the response:

Prices

average_price: Average asking price of the zone, in €, with min_value, max_value and the variations variation_mom and variation_yoy in percentage.
unit_average_price: Average asking unit price of the zone, in €/m², same shape.
unit_price_forecast: Forecast of the unit price, as category and value pairs in €/m².

Supply and demand

listings.total: Number of listings currently on the market in the zone.
listings.variation_mom / listings.variation_yoy: Variation against the previous month and the previous year, in percentage.
listings_quantity_chart: Historical series of the number of listings.
demand_variation_chart: Historical series of the demand of the zone.
time_to_market_chart: Historical series of the time listings stay on the market, in months.
time_to_sell_chart: Historical series of the time needed to sell, in months.
potential_interest_rating: Rating of the potential interest for the property, from 0 to 5.
real_interest_rating: Rating of the interest actually recorded, from 0 to 5.

Composition of the listings

Each of the following is a list of id, label and value triples, where value is a percentage of the listings of the zone. Switch on id, display label.

number_of_rooms: Distribution by number of rooms.
maintenance_status: Distribution by maintenance condition.
types: Distribution by property typology, as label and value pairs, without id.
dynamics: Dynamics of the listings, such as totale_annunci and stabili, with the variation against the previous period in percentage.
discounts: Discount indicators of the zone, such as annunci_ribassati and ribasso_medio, with their variation.

Pie charts

Shares of the listings of the zone, in percentage:

pie_chart_elevator: With and without a lift, as yes and no.
pie_chart_garage: With and without a garage.
pie_chart_garden: With and without a garden.
pie_chart_terrace: With and without a terrace.
pie_chart_floor: On the ground floor or not.
pie_chart_energy_class: Split into high_class, medium_class and low_class.
pie_chart_interest_features: Features attracting the interest, as categoryId, label, color and value.

Scatter charts

price_surface_chart: Price against surface. series holds the points as x (surface in m²), y (price in €), id and categoryId; legend maps every categoryId to its label and color.
time_price_chart: Price against time on the market, same shape, with x expressed in months.

Zone and header

zone.address: Zone the data refers to.
zone.reference_period: Reference period of the data, in Italian.
header: Recap of the valued property for the page of the report.

Colours are provided by the API

Charts carry the palette to render them: color in the legends and in pie_chart_interest_features. Some values come with a leading space, such as " #E31A8D": trim them before use.

Example Response

Note

Every list and series is truncated to two entries in the example below, the actual response returns the whole data set.

{
  "_metadata": {
    "message": "",
    "query": {},
    "status": 200
  },
  "data": {
    "average_price": {
      "max_value": 150000,
      "min_value": 140000,
      "value": 155300,
      "variation_mom": 2000,
      "variation_yoy": 12
    },
    "demand_variation_chart": [
      {
        "category": "6-2025",
        "value": 3159.74
      },
      {
        "category": "7-2025",
        "value": 2917.17
      }
    ],
    "discounts": [
      {
        "id": "annunci_ribassati",
        "label": "Annunci ribassati",
        "value": 0,
        "variation": 0
      },
      {
        "id": "ribasso_medio",
        "label": "Ribasso medio",
        "value": 0,
        "variation": 0
      }
    ],
    "dynamics": [
      {
        "id": "totale_annunci",
        "label": "totale annunci",
        "value": 16,
        "variation": 14.29
      },
      {
        "id": "stabili",
        "label": "stabili",
        "value": 8,
        "variation": -33.33
      }
    ],
    "header": {
      "address": "Via Adolfo Sironi",
      "asset_type": "Pentalocale",
      "city": "Prato",
      "surface": 90.0
    },
    "listings": {
      "total": 16,
      "variation_mom": 14.29,
      "variation_yoy": 43.75
    },
    "listings_quantity_chart": [
      {
        "category": "8-2025",
        "value": 13
      },
      {
        "category": "9-2025",
        "value": 17
      }
    ],
    "maintenance_status": [
      {
        "id": "1",
        "label": "Nuovo / In costruzione",
        "value": 0
      },
      {
        "id": "2",
        "label": "Ottimo / Ristrutt.",
        "value": 66.0
      }
    ],
    "number_of_rooms": [
      {
        "id": "1",
        "label": "1 locale",
        "value": 0
      },
      {
        "id": "2",
        "label": "2 locali",
        "value": 12
      }
    ],
    "pie_chart_elevator": {
      "no": 47,
      "yes": 53
    },
    "pie_chart_energy_class": {
      "high_class": 9,
      "low_class": 64,
      "medium_class": 27
    },
    "pie_chart_floor": {
      "no": 88,
      "yes": 12
    },
    "pie_chart_garage": {
      "no": 93,
      "yes": 7
    },
    "pie_chart_garden": {
      "no": 82,
      "yes": 18
    },
    "pie_chart_interest_features": [
      {
        "categoryId": "1",
        "color": "#6A3B9A",
        "label": "1 locale",
        "value": 11.54
      },
      {
        "categoryId": "2",
        "color": " #E31A8D",
        "label": "2 locali",
        "value": 23.08
      }
    ],
    "pie_chart_terrace": {
      "no": 94,
      "yes": 6
    },
    "potential_interest_rating": 2.0,
    "price_surface_chart": {
      "legend": [
        {
          "categoryId": "1",
          "color": "#6A3B9A",
          "label": "1 locale"
        },
        {
          "categoryId": "2",
          "color": " #E31A8D",
          "label": "2 locali"
        }
      ],
      "series": [
        {
          "categoryId": "3",
          "id": 2,
          "x": 65,
          "y": 155000
        },
        {
          "categoryId": "3",
          "id": 3,
          "x": 89,
          "y": 155000
        }
      ]
    },
    "real_interest_rating": 1,
    "time_price_chart": {
      "legend": [
        {
          "categoryId": "1",
          "color": "#6A3B9A",
          "label": "1 locale"
        },
        {
          "categoryId": "2",
          "color": " #E31A8D",
          "label": "2 locali"
        }
      ],
      "series": [
        {
          "categoryId": "3",
          "id": 2,
          "x": 1.0,
          "y": 155000
        },
        {
          "categoryId": "3",
          "id": 3,
          "x": 0.13333333333333333,
          "y": 155000
        }
      ]
    },
    "time_to_market_chart": [
      {
        "category": "8-2025",
        "value": 4
      },
      {
        "category": "9-2025",
        "value": 4.7
      }
    ],
    "time_to_sell_chart": [
      {
        "category": "8-2025",
        "value": 4
      },
      {
        "category": "9-2025",
        "value": 2
      }
    ],
    "types": [
      {
        "label": "Appartamento",
        "value": 34
      },
      {
        "label": "Casa indipendente",
        "value": 34
      }
    ],
    "unit_average_price": {
      "max_value": 2,
      "min_value": 2,
      "value": 1300,
      "variation_mom": 2,
      "variation_yoy": 12
    },
    "unit_price_forecast": [
      {
        "category": "6-2025",
        "value": 2093
      },
      {
        "category": "7-2025",
        "value": 2105
      }
    ],
    "zone": {
      "address": "Iolo",
      "reference_period": "Dicembre - 2025"
    }
  }
}