Skip to content

Demand

POST /domanda

Demand side of the market for the property: how many users are looking for something like it, at what price they are searching, and the search profile the estimate is based on.

Example Request

curl --location 'https://appraisal.realitycs.it/domanda' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'request_uid=a5108688-bf46-4b0a-b6b9-756396769cba' \
--data-urlencode 'contratto_id=1'

Request Fields

Field Required Default Description Type Example Notes
request_uid yes Identifier of the request string a5108688-bf46-4b0a-b6b9-756396769cba UUID
contratto_id optional 1 Contract type number 1 1 = sale, 2 = rent

JSON keys in the response:

domanda

  • potenziali_interessati: Number of users whose searches match the property.
  • potenziali_acquirenti: Number of users whose searches match the property closely enough to be considered potential buyers, according to trattativa.ricerca.soglia_acquirenti.
  • prezzo_mean_ricerche: Average price searched by the matching users, in €.
  • prezzo_delta_ricerche: Difference between the average searched price and the estimated value of the property, in percentage. A negative value means users are searching below the estimate.
  • prezzo_mq_mean_ricerche: Average unit price searched by the matching users, in €/m².
  • prezzo_mq_delta_ricerche: Difference between the average searched unit price and the estimated unit value of the property, in percentage.
  • periodi: Monthly history of the searched prices, most recent period first.
  • periodi[].periodo: Reference period, in YYYYMM format.
  • periodi[].prezzo_medio: Average price searched in the period, in €.
  • periodi[].prezzo_medio_mq: Average unit price searched in the period, in €/m².

attrattivita

Attractiveness index of the property. May be null when it cannot be computed for the given request.

trattativa

Echo of the profile used to match the searches, useful to explain the numbers above.

  • immobile: Attributes of the valued property taken into account by the matching.
  • pesiRicerche: Weight assigned to every attribute during the matching. 0.0 means the attribute has been ignored.
  • ricerca.contratto: Contract the searches were filtered on, vendita or affitto.
  • ricerca.soglia_acquirenti: Matching score above which an interested user is counted as a potential buyer.

Units depend on contratto_id

With contratto_id=1 the figures refer to sale searches, with contratto_id=2 to rent searches, where prices are monthly rents.

Example Response

Note

The periodi array is truncated to four periods in the example below, the actual response returns the whole history.

{
  "attrattivita": null,
  "domanda": {
    "periodi": [
      {
        "periodo": "202607",
        "prezzo_medio": 525000,
        "prezzo_medio_mq": 6000
      },
      {
        "periodo": "202606",
        "prezzo_medio": 535000,
        "prezzo_medio_mq": 6400
      },
      {
        "periodo": "202605",
        "prezzo_medio": 548000,
        "prezzo_medio_mq": 6600
      },
      {
        "periodo": "202604",
        "prezzo_medio": 562000,
        "prezzo_medio_mq": 6600
      }
    ],
    "potenziali_acquirenti": 14,
    "potenziali_interessati": 226,
    "prezzo_delta_ricerche": -7,
    "prezzo_mean_ricerche": 525000,
    "prezzo_mq_delta_ricerche": -9,
    "prezzo_mq_mean_ricerche": 6000
  },
  "trattativa": {
    "immobile": {
      "anno_costruzione": 1960,
      "ascensore": 0,
      "bagni": 1,
      "box_auto": "",
      "classe_energetica": 7,
      "lat": "45.4775832",
      "lng": "9.1858904",
      "locali": 4,
      "piano_n": 3,
      "riscaldamento_id": 1,
      "stato": 2,
      "superficie": 90.0,
      "tipologia_id": 1
    },
    "pesiRicerche": {
      "bagni": 1.0,
      "balcone": 1.0,
      "cantina": 0.0,
      "classe_energetica_ordinale": 1.0,
      "garage": 1.0,
      "giardino": 1.0,
      "locali_max": 1.0,
      "locali_min": 1.0,
      "piano": 1.0,
      "riscaldamento_id": 1.0,
      "stato_ordinale": 1.0,
      "superficie_max": 1.0,
      "superficie_min": 1.0,
      "terrazzo": 0.0
    },
    "ricerca": {
      "contratto": "vendita",
      "soglia_acquirenti": 0.8
    }
  }
}