Idealista Spain, Portugal & Italy Real Estate Scraper 🏠 Sale, Rent & Rooms

English | Português

---

English

Extract comprehensive real estate listings from Idealista.com (Spain), Idealista.pt (Portugal), and Idealista.it (Italy) with ease. Whether you need houses, apartments, commercial locals, land plots, or shared rooms, this scraper collects everything you need!

This Actor uses Pay-Per-Event (PPE) pricing, meaning you only pay for the real data you actually extract — no monthly subscriptions or upfront fees required.

Features

• 🌐 Multi-Country Support: Scrapes Idealista Spain, Portugal, and Italy.
• 🏢 All Property Types: Supports Apartments, Houses, Shared Rooms, Land, and Commercial offices.
• 🔑 Transaction Modes: Supports buying (Sale), renting, and roommate sharing (Rooms).
• 💰 Pay-Per-Event Billing: Only $0.0025 per extracted listing. Immediate billing, zero free-trial delays.
• 🛡️ Anti-Bot Evasion: Integrated stealth mechanisms and optimized crawling speeds to maximize bypass success against Cloudflare/Datadome.
• ⚡ Rich Structured Data: Extracts ID, title, price, area, bedroom/bathroom count, floor, lift/elevator status, energy certificate, advertiser/agency, and full image lists.

Input Parameters

Field	Type	Description	Default
url	String	Direct Idealista search URL. Overrides other filters.	""
country	String	Country site to scrape (es, pt, it).	"es"
transactionType	String	sale (Buy), rent (Rent), or share (Shared rooms).	"sale"
propertyType	String	all, apartments, houses, rooms, commercial, land.	"all"
location	String	City or region slug (e.g. madrid, lisboa, porto).	"madrid"
priceMin	Integer	Minimum price in Euros.	None
priceMax	Integer	Maximum price in Euros.	None
maxListings	Integer	Maximum number of listings to extract.	100
proxyConfiguration	Object	Proxy configuration. Residential proxy highly recommended.	{"useApifyProxy": true}

Output Example

{
  "id": "104859384",
  "title": "Piso en venta en calle de Alcalá, Goya, Madrid",
  "price": 450000,
  "priceFormatted": "450.000 €",
  "transactionType": "sale",
  "propertyType": "apartments",
  "area": 85,
  "bedrooms": 2,
  "bathrooms": 1,
  "floor": "3º",
  "hasLift": true,
  "energyCertificate": "E",
  "advertiser": "Altea Real Estate",
  "location": "Goya, Madrid",
  "images": [
    "https://img3.idealista.com/blur/web_gallery-m-d/0/id.pro.es.image.bundle.webp"
  ],
  "imageCount": 12,
  "url": "https://www.idealista.com/inmueble/104859384/",
  "pricePerSqm": 5294.12,
  "source": "Idealista",
  "country": "ES",
  "scrapedAt": "2026-05-23T06:20:00.000Z"
}

Use Cases

• 📊 Market Valuation: Track real estate price trends across European cities in real-time.
• 🎯 Lead Generation: Discover fresh listings and contact property advertisers/agencies instantly.
• 💼 Investment Analysis: Calculate yield/ROI ratios for long-term rentals vs. vacation models.

✅ Capabilities & Limits

Stated up front, so you do not pay a run to find out. Derived from this Actor's own input schema.

Input / feature	Supported	Notes
url	✅	Direct search URL from Idealista.com, Idealista.pt, or Idealista.it. If provided, other filters below will be ignored. Example:…
country	✅	Idealista site to scrape from.
transactionType	✅	Type of transaction to search for.
propertyType	✅	Type of property to search for.
location	✅	Slug of the location. Examples: madrid, barcelona, lisboa, porto, milano, roma. If empty, defaults to 'madrid'.
priceMin	✅	Minimum price filter in Euros. Example: 100000 for €100,000
priceMax	✅	Maximum price filter in Euros. Example: 300000 for €300,000
Result volume (maxListings)	⚠️	Maximum number of listings to extract. Each page has ~30 listings.
Proxy	⚠️	Proxy configuration. Using Apify RESIDENTIAL proxy is highly recommended to bypass Cloudflare/Datadome protections.

FAQ

Q: Do I need a proxy to run this scraper?
A: Yes. Idealista uses heavy anti-bot protections. It is highly recommended to use Apify Residential Proxies or the Web Unlocker in the proxy configuration settings.

Q: How does the Pay-Per-Event model work?
A: You are only charged per listing successfully scraped and saved to your dataset. If a run fails or returns 0 results due to a block, you pay absolutely nothing.

---

Português

Extraia anúncios imobiliários completos do Idealista.com (Espanha), Idealista.pt (Portugal) e Idealista.it (Itália) de forma simples. Seja para casas, apartamentos, escritórios comerciais, terrenos ou quartos partilhados, este scraper recolhe tudo o que precisa!

Este Actor utiliza a cobrança Pay-Per-Event (PPE) via API, o que significa que paga apenas pelos dados reais que extrair — sem subscrições mensais ou taxas iniciais.

Funcionalidades

• 🌐 Suporte Multi-País: Extração nos portais de Espanha, Portugal e Itália.
• 🏢 Todos os Tipos de Propriedade: Apartamentos, Casas, Quartos Partilhados, Terrenos e Escritórios/Lojas.
• 🔑 Modos de Transação: Compra (Venda), Arrendamento e Quartos (Partilhar).
• 💰 Cobrança Pay-Per-Event: Apenas $0.0025 por anúncio extraído. Cobrança imediata e sem períodos de teste gratuitos.
• 🛡️ Evasão Avançada de Bots: Mecanismos de camuflagem integrados contra detecção de webdrivers e bloqueios de Cloudflare/Datadome.
• ⚡ Dados Ricos e Estruturados: Retorna ID, título, preço, área, quartos/casas de banho, andar, elevador, certificado energético, anunciante e lista completa de imagens.

Parâmetros de Entrada

Campo	Tipo	Descrição	Padrão
url	String	URL direta de pesquisa do Idealista. Ignora outros filtros.	""
country	String	Portal de país a extrair (es, pt, it).	"es"
transactionType	String	sale (Venda), rent (Arrendamento) ou share (Quartos).	"sale"
propertyType	String	all, apartments, houses, rooms, commercial, land.	"all"
location	String	Termo ou slug da localidade (ex: lisboa, porto, madrid).	"madrid"
priceMin	Integer	Preço mínimo em Euros.	Nenhum
priceMax	Integer	Preço máximo em Euros.	Nenhum
maxListings	Integer	Número máximo de anúncios a extrair.	100
proxyConfiguration	Object	Configurações de proxy. Proxy residencial recomendado.	{"useApifyProxy": true}

Casos de Uso

• 📊 Avaliação de Mercado: Monitorize a evolução de preços de venda ou arrendamento na Europa em tempo real.
• 🎯 Geração de Leads: Descubra anúncios recém-publicados e entre em contacto com agências imobiliárias ou proprietários particulares.
• 💼 Análise de Investimento: Calcule taxas de retorno (Yield) comparando o arrendamento residencial tradicional de longa duração com quartos.

FAQ

P: Preciso de proxy para rodar este scraper?
R: Sim. O Idealista implementa bloqueios rígidos. Recomendamos fortemente a utilização dos Proxies Residenciais da Apify para garantir o sucesso das extrações.

---

💰 Pricing / Preços

This actor uses Pay Per Event (PPE) pricing. The rate depends on your Apify plan tier:

Plan tier	Per listing scraped	Per 1,000
Free	$0.003	$3.00
Bronze	$0.0025	$2.50
Silver	$0.002	$2.00
Gold	$0.0018	$1.80
Platinum	$0.0014	$1.40
Diamond	$0.001	$1.00

You are never charged for a run that returned nothing. When the source blocks and nothing is extracted, the actor returns a labeled diagnostic and charges no PPE event.

Related Actors / Atores Relacionados

• Brazil Real Estate Scraper
• Mercado Livre Multi-Country Scraper
• Airbnb Latin America Scraper

Changelog

• v1.0.0 (2026-05-23): Lançamento oficial do Idealista Multi-Country Scraper com cobrança PPE direta e suporte a Espanha, Portugal e Itália.