Using the Idealista Discovery API

Search Idealista real estate listings and extract structured property data using the ZenRows Idealista Discovery API with pagination support.

The Idealista Discovery API enables seamless extraction of property listings from Idealista, providing structured search results with detailed property information. This API helps users retrieve real estate data efficiently, including pagination details for easy navigation.

• Retrieve the total number of search results.
• Access detailed property information, including:
  • Address (full street, city, and postal code).
  • Property size in square meters.
  • Number of bedrooms and bathrooms.
  • Price, including currency and symbol.
  • Direct links to individual property listings.
• Obtain the search query and corresponding title for reference.

Supported Query Parameters

PARAMETER	TYPE	DEFAULT	DESCRIPTION
url	string <uri>		The URL where the desired search data must be retrieved from. Example: https://www.idealista.com/alquiler-viviendas/barcelona-provincia/.
lang	string	Language of the target country	The language to display results. Supported values: "en", "es", "ca", "it", "pt", "fr", "de", "da", "fi", "nb", "nl", "pl", "ro", "ru", "sv", "el", "zh", "uk". The default is the language of the target country (e.g., "es" for .com, "it" for .it, and "pt" for .pt). Example: lang=en.
page	number		The search results page to retrieve. Example: page=2.
order	string		Determines the sorting of search results based on specified criteria. Supported values: "relevance", "lowest_price", "highest_price", "most_recent", "least_recent", "highest_price_reduction", "lower_price_per_m2", "highest_price_per_m2", "biggest", "smallest", "highest_floors", "lowest_floors". Example: order=most_recent.

How to Setup

Make a request to the search endpoint with your desired query:

https://realestate.api.zenrows.com/v1/targets/idealista/discovery?url={url}&apikey=YOUR_ZENROWS_API_KEY

Example

cURL

curl "https://realestate.api.zenrows.com/v1/targets/idealista/discovery/?apikey=YOUR_ZENROWS_API_KEY&url=https%3A%2F%2Fwww.idealista.com%2Falquiler-viviendas%2Fbarcelona-provincia%2F"

The URL search query must be encoded.

Python

# pip install requests
import requests

url = 'https://www.idealista.com/alquiler-viviendas/barcelona-provincia/'
apikey = 'YOUR_ZENROWS_API_KEY'
params = {
    'apikey': apikey,
    'url': url,
}

response = requests.get('https://realestate.api.zenrows.com/v1/targets/idealista/discovery/', params=params)
print(response.text)

Response Example

{
  "pagination": {
    "current_page": 1,
    "items_count": 6315,
    "items_per_page": 20,
    "page_count": 316
  },
  "property_list": [
    {
      "bedrooms_count": 4,
      "operation": "rent",
      "price_currency_symbol": "€",
      "property_description": "FINCAMPS alquila amplio piso señorial en Plaza Granados de Sabadell.  Al entrar, un distribuidor nos lleva a un soleado salón-comedor de 40m2 con salida a balcón.  Cocina independiente totalmente equipada con electrodomésticos y galería, una habitación con armarios empotrados junto a la cocina.  En zona noche encontramos una habitación individual, otra doble y la principal en suite (con bañera) y salida a un gran balcón, todas ellas exteriores. Baño 3 piezas con plato de ducha. Plaza de parking y trastero incluido en el precio.",
      "property_dimensions": 195,
      "property_id": 107313260,
      "property_image": "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image.master/07/5a/c6/1309244931.webp",
      "property_price": 2300,
      "property_title": "Piso en plaza de Granados",
      "property_type": "flat",
      "property_url": "https://www.idealista.com/inmueble/107313260/"
    },
    {
      "bedrooms_count": 2,
      "operation": "rent",
      "price_currency_symbol": "€",
      "property_description": "¡ALQUILA AHORA Y LLÉVATE EL PRIMER MES GRATIS! Piso de 2 dormitorios con terraza de 13 metros! Viviendas muy luminosas de 1, 2 y 3 habitaciones, plantas bajas y áticos. Excelente ubicación, en el centro de Badalona, y con inmejorables conexiones en transporte público (frente a la parada de Metro Pompeu Fabra) o privado. Amplios espacios comunes que incluyen gimnasio, CoWorking, CoLiving, Relax Area y muchos servicios más. Además, el residencial dispone de un gran patio interior al aire libre donde relajarse desconectando del ruido del exterior. Los pisos de alquiler están ubicados en la calle de Coll i Pujol, 1, al lado de la Plaza Alcalde Xifré, a solo 10 minutos caminando de la playa. Su localización, en el centro de Badalona, invita a disfrutar del ocio en la ciudad: compras en la calle del Mar, caminatas por el paseo marítimo, tardes en los parques y jardines, jornadas en los clubs náuticos. BCN HOUSING está contigo y te ayudamos a que la búsqueda de tu futura vivienda de alquiler sea cómoda, fácil y rápida. Nos gustaría mucho mostrarte nuestro residencial: los espacios comunitarios y las viviendas. Puedes pedir tu visita. ¡Pídenos cita personalizada! Ventajas de formar parte de la comunidad BCN HOUSING - Vivienda luminosa que consta de 3 dormitorios y 2 baños.  - Electrodomésticos: horno, microondas, placa de inducción, campana, nevera, lavadora-secadora y lavaplatos - Calificación energética A - Gimnasio completamente equipado - CoWorking \u0026 espacio para reuniones - Wellness - Micro Market 24h - Smart Point - Parking - Seguridad: sistema de videovigilancia  - Servicio de conserjería - Todos los suministros dados de alta. Se hace cambio de titularidad. - Plaza de garaje opcional por 100€/mes. REQUISITOS 1 mes de fianza Seguro de impago Seguro de hogar Se solicitarán 3 últimas nóminas o similar para acreditar ratio de solvencia. En conformidad a la nueva normativa de vivienda, se informa: •Vivienda perteneciente a gran tenedor. •Precio contrato anterior: 1.655 € •Precio Índice de referencia: no aplica por no existir para el edificio (adjunto en fotografías).",
      "property_dimensions": 55,
      "property_id": 101784660,
      "property_image": "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image.master/53/19/f9/1133684811.webp",
      "property_price": 1620,
      "property_title": "Piso en calle Coll i Pujol, 17",
      "property_type": "flat",
      "property_url": "https://www.idealista.com/inmueble/101784660/"
    },
    {
      "bedrooms_count": 3,
      "operation": "rent",
      "price_currency_symbol": "€",
      "property_description": "ALQUILER TEMPORAL  NO SE ATENDERAN LLAMADAS PARA ORGANIZAR VISITAS, ENVIAR SOLICITUD. Volkvillage comercializa piso en alquiler temporal, ideal para Estudiantes Universitarios, Master, MIR o trabajadores destinados temporalmente a la zona de Terrassa o alrededores.  Os presentamos bonito piso de 87m2, listo para entrar a vivir, amueblado y equipado para que te sientas como en casa.  Esta distribuido en: 3 habitaciones 14/12/9m2, todas exteriores, cocina tipo office de 7m2 con salida a lavadero de 5m2, baño con plato de ducha de 6m2 y gran comedor de 25m2 con salida a balcón de 8m2 orientado a Este. La cocina se entrega equipada Cocina con fogonera, horno, campana, microondas, nevera combi y lavadora.  Suelos de terrazo, carpintería exterior de aluminio con vidrios dobles y sistema de rotura térmica, interior en embero, el piso dispone de calefacción y todos los suministros dados de alta. Es un 9º piso y la finca tiene de ascensor.  El piso se entrega amueblado y cocina equipada.  Está situado en el barrio de Can Jofresa, a 5 minutos del Parc Vallés i Vallparadís. Hay que destacar el fácil acceso/salida a la ciudad y la buena comunicación con transporte público.  Envíanos una solicitud y uno de nuestros agentes te llamará para informarte de todo.",
      "property_dimensions": 90,
      "property_id": 107313258,
      "property_image": "https://img4.idealista.com/blur/WEB_LISTING/0/id.pro.es.image.master/a7/32/1e/1309244783.webp",
      "property_price": 795,
      "property_title": "Piso en calle de Montblanc",
      "property_type": "flat",
      "property_url": "https://www.idealista.com/inmueble/107313258/"
    }
  ]
}