Datos estadísticos

• Introducción
• Listado de conjuntos de datos
• Datos de un conjunto

A través de este punto de acceso se proporcionan datos estadísticos de España obtenidos de distintas fuentes. Estos datos son los mismos que se encuentran en la herramienta de Datos y se actualizan regularmente.

Los datos estadísticos están agrupados en conjuntos que se identifican cada uno con un groupkey. Para cada conjunto de datos, es posible obtener datos estadísticos en determinados niveles de delimitación que pueden ser Country, Province, Municipality, Section y District.

En esta página se muestran ejemplos del uso de la API para la obtención de datos estadísticos. Para la documentación completa, puedes acceder a la referencia de la API.

/v1/statistics/

Los conjuntos de datos determinan la agrupación de los datos estadísticos. Cada conjunto de datos se identifica con un groupkey que se usa para consultar los datos estadísticos. Asimismo cada conjunto de datos muestra información acerca de los niveles de delimitación delimitations y un título descriptivo title del conjunto de datos.

Añade el parámetro &language=es para obtener los nombres de los conjuntos de datos en español.

Solicitud

curl -H "x-api-key: your_api_key" -G https://api.goolzoom.com/v1/statistics/?language=es

Respuesta

{
  "groupkeys": [
    {
      "groupkey": "housing_sales_prices",
      "title": "Precios de venta",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_rental_prices",
      "title": "Precios de alquiler",
      "delimitations": [
        "District",
        "Section",
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_valutations",
      "title": "Tasaciones",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_mortages",
      "title": "Hipotecas",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_sales",
      "title": "Transacciones",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_transmissions",
      "title": "Transmisiones",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_amount",
      "title": "Parque",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_new_houses",
      "title": "Nueva",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "housing_free_houses",
      "title": "Libre",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "hougins_protected",
      "title": "Protegida",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "plot_sales",
      "title": "Compraventas",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "plot_rustic",
      "title": "R\u00FAstico",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "population_census",
      "title": "Padr\u00F3n",
      "delimitations": [
        "Section",
        "Municipality",
        "Province"
      ]
    },
    {
      "groupkey": "population_growth",
      "title": "Crecimiento",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "population_projection",
      "title": "Proyecci\u00F3n",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "population_income",
      "title": "Renta",
      "delimitations": [
        "Section",
        "Municipality",
        "Province"
      ]
    },
    {
      "groupkey": "population_unemployement",
      "title": "Paro",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "population_contracts",
      "title": "Contratos",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "population_social_security",
      "title": "Seguridad Social",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "population_crime",
      "title": "Crimen",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "cadastre_taxes",
      "title": "IBI",
      "delimitations": [
        "Municipality"
      ]
    },
    {
      "groupkey": "cadastre_urban",
      "title": "Urbano",
      "delimitations": [
        "Municipality"
      ]
    },
    {
      "groupkey": "cadastre_rustic",
      "title": "R\u00FAstico",
      "delimitations": [
        "Municipality"
      ]
    },
    {
      "groupkey": "cadastre_owners",
      "title": "Titulares",
      "delimitations": [
        "Municipality"
      ]
    },
    {
      "groupkey": "cadastre_uses",
      "title": "Usos",
      "delimitations": [
        "Municipality"
      ]
    },
    {
      "groupkey": "companies_dirce",
      "title": "DIRCE",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "companies_commercial",
      "title": "Mercantiles",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "companies_bankrupt",
      "title": "Concursadas",
      "delimitations": [
        "Province",
        "Country"
      ]
    },
    {
      "groupkey": "citycouncils_debt",
      "title": "Deuda",
      "delimitations": [
        "Municipality",
        "Province",
        "Country"
      ]
    }
  ]
}

/v1/statistics/{groupkey}/{delimitationcode}

Para obtener el listado de datos, necesitamos, por un lado el conjunto de datos {groupkey} y, por otro lado, el código de delimitación del INE o {delimitationcode}.

La API genera por defecto un JSON con los datos estadísticos solicitados con los valores como objetos de dicho JSON. Pero si quieres obtener los valores como un array para generar un gráfico más fácilmente, añade el parámetro &chartformat=true.

También se muestra por defecto el histórico de estadísticas, pero si quieres obtener únicamente el último valor, añade el parámetro &justlast=true.

En el siguiente ejemplo, se solicita el último valor &justlast=true de los datos estadísticos de precios de vivienda /housing_sales_prices/ del municipio de Las Rozas de Madrid /28127 en español &language=es.

Solicitud

curl -H "x-api-key: your_api_key" -G https://api.goolzoom.com/v1/statistics/housing_sales_prices/28127?language=es&justlast=true

Respuesta

{
    "statistics": [
        {
            "title": "Precios de venta de vivienda",
            "units": "€/m2",
            "sources": [
                {
                    "name": "Idealista",
                    "url": "https://www.idealista.com/"
                },
                {
                    "name": "Fotocasa",
                    "url": "https://www.fotocasa.es/"
                },
                {
                    "name": "Notariado",
                    "url": "http://www.notariado.org/"
                },
                {
                    "name": "MFOM",
                    "url": "https://www.fomento.gob.es/"
                },
                {
                    "name": "Tinsa",
                    "url": "https://www.tinsa.es/"
                }
            ],
            "fields": [
                {
                    "name": "MFOM",
                    "values": [
                        {
                            "date": "3T/2020",
                            "value": 2880.7
                        }
                    ]
                }
            ]
        }
    ]
}

Si el valor del dato es null quiere decir que no existe dato estadítitico para una determinada fecha.

En cada solicitud, además se genera el objeto sources: que muestra información sobre las fuentes de las que se han obtenido los datos.