Population

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

Demographics of the area around the property: residents, households, nationalities and the population pyramid.

Example Request

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

population.total: Resident population of the area.
population.variation: Variation of the resident population, in percentage.
population.year: Year of the census the data comes from.
total_families: Number of resident households.
family_member_count: Distribution of the households by number of members, in percentage, as id, label and value triples. The m5 id groups households of more than five members.
nationalities: Share of italians and foreigners on the resident population, in percentage.
origin: Share of the foreign residents by continent of origin (europe, africa, america, asia, oceania), in percentage.
population_description: Narrative summary of the demographics of the area, in Italian, ready to be displayed.
price_graph: Historical series as category and value pairs, where category is the year.
population_pyramid: Population pyramid, one entry per age band.

population_pyramid

category: Age band, such as 40-49.
category2: Birth year range matching the band, such as 1983 - 1974.
male / female: Residents of that band by marital status, split into single, married, divorced and widowed.

Scope of the figures

population, total_families, family_member_count, nationalities and origin describe the area within the radius of the report. The population_pyramid is computed at municipality level, so its totals are much larger and are not comparable with population.total.

origin percentages

The values of origin are shares of the foreign resident population and add up to 100 among themselves, while nationalities.foreigners gives the weight of foreigners on the whole area.

Example Response

Note

The population pyramid is truncated to two age bands and the description is abridged in the example below, the actual response returns every band and the full text.

{
  "_metadata": {
    "message": "",
    "query": {},
    "status": 200
  },
  "data": {
    "family_member_count": [
      {
        "id": "1",
        "label": "1 componente",
        "value": 28
      },
      {
        "id": "2",
        "label": "2 componenti",
        "value": 28
      },
      {
        "id": "3",
        "label": "3 componenti",
        "value": 20
      },
      {
        "id": "4",
        "label": "4 componenti",
        "value": 16
      },
      {
        "id": "5",
        "label": "5 componenti",
        "value": 5
      },
      {
        "id": "m5",
        "label": ">5 componenti",
        "value": 3
      }
    ],
    "nationalities": {
      "foreigners": 10,
      "italians": 90
    },
    "origin": {
      "africa": 6,
      "america": 1,
      "asia": 70,
      "europe": 23,
      "oceania": 0
    },
    "population": {
      "total": 3097,
      "variation": 2.79,
      "year": 2011
    },
    "population_description": "Analizzando i dati socio economici dell’area intorno all’immobile, entro un raggio di 500 metri vivono circa 3.097 persone [...]",
    "population_pyramid": [
      {
        "category": "90-99",
        "category2": "1933 - 1924",
        "female": {
          "divorced": 0,
          "married": 0,
          "single": 0,
          "widowed": 1610
        },
        "male": {
          "divorced": 0,
          "married": 439,
          "single": 0,
          "widowed": 413
        }
      },
      {
        "category": "80-89",
        "category2": "1943 - 1934",
        "female": {
          "divorced": 0,
          "married": 2297,
          "single": 413,
          "widowed": 4279
        },
        "male": {
          "divorced": 0,
          "married": 3535,
          "single": 0,
          "widowed": 933
        }
      }
    ],
    "price_graph": [
      {
        "category": "2020",
        "value": 5
      },
      {
        "category": "2021",
        "value": 10
      },
      {
        "category": "2022",
        "value": 8
      },
      {
        "category": "2023",
        "value": 20
      },
      {
        "category": "2024",
        "value": 15
      }
    ],
    "total_families": 1198
  }
}