Precio Vivienda España | Spain House Prices Scraper

Español

Consulta el precio de la vivienda en España por código postal utilizando valores reales de venta agregados a partir de compraventas formalizadas ante notario. Este Actor utiliza directamente la API pública del mapa del Portal Estadístico del Notariado: no abre un navegador ni extrae precios de anuncios de Idealista.

Por qué importa: precio vendido frente a precio anunciado

Idealista muestra principalmente el precio que pide el vendedor. Ese precio de oferta puede negociarse, reducirse o no terminar nunca en una venta. Los datos notariales proceden de compraventas que sí se formalizaron y reflejan el precio declarado al cerrar la operación.

Por eso estos datos son una referencia más sólida para valorar una vivienda, comparar códigos postales o analizar el mercado real. Los resultados son estadísticas agregadas —no escrituras ni operaciones individuales— y no sustituyen una tasación profesional.

Datos disponibles

Cada código postal puede incluir:

• precio por metro cuadrado en euros
• precio medio de compraventa
• superficie media
• número de compraventas y operaciones con precio informado
• indicación de valor estimado
• geometría opcional de los límites del código postal

Los resultados son agregados de compraventas reales, no precios de oferta. El servicio de origen aplica umbrales mínimos de muestra, por lo que algunos códigos postales o combinaciones de filtros pueden devolver campos de precio con valor null o no devolver ninguna fila. Un valor null no significa que no hubiese compraventas: consulta salesCount y pricedSalesCount para interpretar la muestra.

Estrategia de proxy

El Actor prueba primero el proxy principal configurado. De forma predeterminada utiliza el grupo más económico de proxies de centro de datos de Apify. Si recibe un bloqueo, límite de peticiones, error temporal o una página HTML de mantenimiento, reintenta automáticamente mediante un proxy residencial situado en España.

Cada registro indica qué tipo de proxy produjo el resultado.

Ejemplo de entrada

{
  "postalCodes": ["29700", "28001", "08001"],
  "propertyType": "all",
  "constructionType": "all",
  "includeGeometry": false,
  "primaryProxyConfiguration": { "useApifyProxy": true },
  "residentialFallback": true
}

Activa allPostalCodes para descargar todos los códigos postales disponibles con una combinación de tipo de vivienda y construcción.

Filtros

Los dos filtros son independientes y se pueden combinar. Por ejemplo, propertyType: apartment junto con constructionType: resale devuelve únicamente pisos libres de segunda mano. Cada combinación devuelve como máximo una fila agregada por código postal.

Valor de entrada	Significado	ID oficial
propertyType: all	Todas las viviendas	99
propertyType: apartment	Vivienda-piso libre	14
propertyType: single_family	Vivienda unifamiliar libre	15
constructionType: all	Obra nueva y segunda mano	99
constructionType: new_build	Obra nueva	7
constructionType: resale	Segunda mano	9

all no elimina el filtro ni suma resultados dentro del Actor. El ID oficial 99 selecciona la estadística agregada que el propio Portal del Notariado publica para todas las categorías. Esto evita recalcular precios medios o €/m² de forma incorrecta.

Ejemplos:

• apartment + resale: pisos libres de segunda mano
• single_family + new_build: viviendas unifamiliares libres de obra nueva
• all + all: agregado oficial de todas las viviendas y ambos tipos de construcción

Fuente y condiciones de publicación

Fuente: mapa público del Portal Estadístico del Notariado y su servicio público ArcGIS Feature Service. El Actor localiza dinámicamente el mapa web de producción actual para no depender de una versión concreta del servicio.

---

English

Get Spain house prices by postcode using real sold values aggregated from transactions completed before a Spanish notary. This Actor queries the public Portal Estadístico del Notariado map API directly. It does not launch a browser or scrape Idealista listing prices.

Why it matters: sold price vs asking price

Idealista primarily shows the price requested by the seller. That asking price may be negotiated down, reduced later, or never result in a sale. Notarial data comes from transactions that were actually completed and reflects the price declared when the sale closed.

This makes the data a stronger reference for property valuation, postcode comparisons, and analysis of the real market. Results are aggregated statistics—not deeds or individual transactions—and do not replace a professional valuation.

Available data

Each postcode can include:

• price per square metre in euros
• average completed-sale price
• average floor area
• completed-sale count and priced-sale count
• estimated-value indicator
• optional postcode boundary geometry

Results are aggregates from completed notarised sales, not asking prices. The source applies minimum-sample rules, so some postcodes or filter combinations may return null price fields or no row. A null value does not necessarily mean there were no sales: use salesCount and pricedSalesCount to interpret the sample.

Proxy strategy

The Actor first uses the configured primary proxy. By default, this is the cheaper Apify datacenter pool. Responses that look blocked, rate-limited, unavailable, or replaced with maintenance HTML automatically fall back to an Apify Residential proxy in Spain.

Each dataset record identifies the proxy tier that supplied it.

Example input

{
  "postalCodes": ["29700", "28001", "08001"],
  "propertyType": "all",
  "constructionType": "all",
  "includeGeometry": false,
  "primaryProxyConfiguration": { "useApifyProxy": true },
  "residentialFallback": true
}

Set allPostalCodes to true to export every available Spanish postcode for one property/construction filter combination.

Filters

The two filters are independent and can be combined. For example, propertyType: apartment with constructionType: resale returns only free-market resale apartments. Each combination returns at most one aggregate row per postcode.

Input	Meaning	Official ID
propertyType: all	All homes	99
propertyType: apartment	Free-market apartments	14
propertyType: single_family	Free-market single-family homes	15
constructionType: all	New and resale	99
constructionType: new_build	New build	7
constructionType: resale	Resale	9

all does not omit the filter or sum records inside the Actor. Official ID 99 selects the all-category aggregate published by the Notariat portal itself. This avoids incorrectly recomputing average prices or price per square metre.

Examples:

• apartment + resale: free-market resale apartments
• single_family + new_build: free-market new-build single-family homes
• all + all: the official aggregate for all homes and both construction types

Data source and publication notice

Source: the public Portal Estadístico del Notariado map and its public ArcGIS Feature Service. The Actor dynamically resolves the current production web map instead of hard-coding a particular service version.