Inmobiliario

Idealista Scraper

idealista.com

Idealista se sirve mediante dos endpoints de plugin dedicados en lugar de la obtención de página genérica, en sus tres sitios: idealista.com (España), idealista.it (Italia) e idealista.pt (Portugal). El endpoint de búsqueda acepta una ubicación tal como idealista la escribe en sus URL (un municipio como madrid-madrid o milano-milano, un distrito como madrid/centro o lisboa/arroios, o una provincia como malaga-provincia) o cualquier URL de búsqueda de idealista con sus filtros, y devuelve los anuncios ya analizados: ID, enlace, título, precio con moneda y periodo de alquiler, el precio original y la bajada en porcentaje tras una rebaja, precio por m², superficie, habitaciones, planta, indicadores de ascensor, exterior y plaza de garaje, descripción, etiquetas, fotos, indicadores de plano, vídeo y visita 3D, y la agencia. Filtra por venta o alquiler, tipo de inmueble (viviendas, obra nueva, oficinas, locales, garajes, terrenos, trasteros, edificios o habitaciones en alquiler), rangos de precio y superficie, habitaciones, baños y características como ascensor, terraza, piscina o jardín, y ordena por precio, fecha, superficie, precio por m² o mayor bajada de precio. Los resultados llegan de 30 en 30 por página, y una llamada reúne hasta 300 entre páginas, hasta las 60 páginas que idealista muestra por búsqueda. El endpoint de detalle acepta un ID o una URL de anuncio y devuelve el anuncio completo: título, ubicación, operación, tipo de inmueble, precio, el desglose de precio que muestra idealista (como gastos de comunidad o fianza), superficie construida y útil, habitaciones, baños, planta, ascensor, año de construcción, clase y consumo energéticos, todos los grupos de características que lista idealista, descripción, líneas de dirección, coordenadas, la galería de fotos, los planos, el anunciante y la última actualización. No hace falta cuenta de idealista ni clave de API.

Qué puedes extraer

• ID del anuncio, enlace, título, precio, moneda y periodo de alquiler
• Precio original y bajada en porcentaje tras una rebaja, y precio por m²
• Superficie, habitaciones, planta, indicadores de ascensor, exterior y plaza de garaje
• Descripción, etiquetas, fotos e indicadores de plano, vídeo y visita 3D
• Agencia, y si el anunciante es profesional
• Filtros: venta o alquiler, nueve tipos de inmueble, rangos de precio y superficie, habitaciones, baños y 14 características; 10 órdenes de clasificación
• Detalle: desglose del precio, superficie útil, baños, año de construcción, clase y consumo energéticos, y todos los grupos de características
• Detalle: líneas de dirección, coordenadas, galería de fotos, planos, anunciante y última actualización
• España, Italia y Portugal; 30 anuncios por página, hasta 300 por llamada y 60 páginas por búsqueda

Endpoints dedicados

Cómo rastrearlo

curl -X POST \
  -H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
  "https://api.scrapeunblocker.com/realestate/idealista?location=madrid-madrid&country=es&operation=rent"

import requests

resp = requests.post(
    "https://api.scrapeunblocker.com/realestate/idealista",
    headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
    params={"location": "madrid-madrid", "country": "es", "operation": "rent"},
)
print(resp.text)

import { ScrapeUnblockerClient } from 'scrapeunblocker';

const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });

const results = await su.idealistaSearch('madrid-madrid', {
  country: 'es',
  operation: 'rent',
});
const listing = await su.idealistaDetail('https://www.idealista.it/immobile/37068709/');
console.log(results);
console.log(listing);

Las peticiones son POST y sus parámetros van en la query string. El renderizado en navegador siempre ocurre: no hay ningún flag que activar.

Ejemplo de respuesta

{
  "listings": [
    {
      "id": "88108287",
      "url": "https://www.idealista.com/inmueble/88108287/",
      "title": "Dúplex en Calle de Fortuny, Almagro, Madrid",
      "priceText": "6.750 €/mes",
      "price": 6750,
      "currency": "EUR",
      "pricePeriod": "month",
      "parking": "included",
      "rooms": 4,
      "area": 176,
      "floor": "6ª planta exterior con ascensor",
      "lift": true,
      "exterior": true,
      "description": "ÁTICO - DUPLEX, en el mejor tramo de la calle Fortuny, en edificio representativo, con PLAZA de GARAJE en el mismo edificio, esta propiedad está distribuida de la siguiente manera:...",
      "tags": [
        "Lujo"
      ],
      "images": [
        "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/4d/4c/40/738803992.jpg"
      ],
      "imageCount": 41,
      "multimedia": [
        "VIDEO"
      ],
      "agency": {
        "name": "Jaime Valcarce Consulting Inmobiliario",
        "url": "https://www.idealista.com/pro/jaime-valcarce-consulting-inmobiliario/",
        "logo": "https://st3.idealista.com/df/c3/43/jaime-valcarce-consulting-inmobiliario.gif"
      },
      "professional": true
    },
    {
      "id": "109738824",
      "url": "https://www.idealista.com/inmueble/109738824/",
      "title": "Piso en Calle de Villamanín, Lucero, Madrid",
      "priceText": "1.800 €/mes",
      "price": 1800,
      "currency": "EUR",
      "pricePeriod": "month",
      "rooms": 3,
      "area": 115,
      "floor": "6ª planta exterior con ascensor",
      "lift": true,
      "exterior": true,
      "published": "1 hora",
      "description": "DISPONIBLE DESDE 1 DE DICIEMBRE. CONTRATO HABITUAL, LARGA ESTANCIA! SE PUEDE VISITAR Y RESERVAR DESDE AHORA. METRO BATAN A 1 MIN. ANDANDO. ¡Descubre tu nuevo hogar en el corazón de...",
      "images": [
        "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/fb/a8/89/1384095761.jpg"
      ],
      "imageCount": 33,
      "professional": true
    }
  ],
  "resultsCollected": 30,
  "totalResults": 9133,
  "heading": "9.133 casas y pisos en alquiler en Madrid",
  "page": 1,
  "pagesFetched": 1,
  "hasMore": true,
  "nextPage": 2,
  "viewLimitReached": false,
  "country": "es",
  "searchUrl": "https://www.idealista.com/alquiler-viviendas/madrid-madrid/",
  "query": {
    "country": "es",
    "operation": "rent",
    "propertyType": "homes",
    "location": "madrid-madrid",
    "sort": "relevance"
  }
}

Leer la documentación

Preguntas frecuentes

Scrapers relacionados