Pricing

from $2.20 / 1,000 listings

Try for free

Go to Apify Store

Idealista Scraper - Spain Italy Portugal Property

Try for free

Scrape Idealista.com / .it / .pt across homes, new builds, rooms, garages, commercial, land, and business transfers by location or URL. Extract prices, rooms, living space, agencies, and photos as an Idealista API alternative.

Pricing

from $2.20 / 1,000 listings

Rating

0.0

(0)

Developer

kane liu

Actor stats

Bookmarked

Total users

Monthly active users

6 hours ago

Last modified

What does Idealista Scraper do?

Scrape Idealista property listings in Spain, Italy, and Portugal for sale and to rent, then export structured real-estate data to an Apify Dataset. This Actor is a practical Idealista API alternative for agencies, investors, researchers, and automations that need clean housing data from:

Idealista Spain (idealista.com)
Idealista Italy (idealista.it)
Idealista Portugal (idealista.pt)

Set country, a location path, or paste Idealista search / detail URLs. Optionally open each listing detail page to enrich prices, rooms, living space, agency contacts, descriptions, and photos. Supports all top-nav Idealista property categories (homes, new builds, rooms, garages, storage, offices, commercial, land, buildings, holiday, business transfer).

This Actor is a thin façade: it validates input and delegates DataDome-aware browser acquisition and parsing through the control plane to the dedicated ns515786 worker (idealista-com). The worker resolves market-matched egress. The Actor itself never launches a browser.

What can this Idealista Scraper do?

Scrape Spain (country=ES) on idealista.com
Scrape Italy (country=IT) on idealista.it
Scrape Portugal (country=PT) on idealista.pt
Scrape for-sale (channel=BUY) and to-rent (channel=RENT)
Scrape all Idealista top-nav property types via propertyType or category startUrls
Build searches from location paths or startUrls
Paginate Idealista search result pages (/pagina-N.htm)
Enrich listings from Idealista detail pages (scrapeDetails), including new-build detail URLs when present
Extract prices, rooms, living space, floor, agency, images, tags, and propertyType (search-card map metadata is not available on the current search channel and is returned as null)
Cap runs with maxItems and maxPages
Run on Apify with scheduling, Dataset export, webhooks, and API access
Market-matched (ES / IT / PT) exit handled by the backend — no proxy setup needed

What data can you extract from Idealista?

Property field	Example
Country	`ES`, `IT`, `PT`
Property type	Local Idealista path (`viviendas`, `negozi`, `lojas_ou_armazens`, …)
Listing ID / URL	Idealista id + detail URL (`/inmueble/`, `/immobile/`, `/imovel/`, `/obra-nueva/`)
Title / address	Card or detail title
Price	`350.000 €`, `1.500 €/mes`
Rooms / living space	`3` / `85` m² (often null for garages, storage, land)
Floor / features	Floor, elevator, orientation when shown
Description	SRP summary or detail description
Agency / advertiser	Search-card agency badge; detail `config` or DOM
Images / plans / videos	Gallery URLs and counts
Channel	`BUY` or `RENT`
Source layer	`srp`, `srp+ldp`

Lead & contact fields

When scrapeDetails is enabled (default ON), each detail item carries the full lead-key set defined by the lead-output schema. SRP-only items (scrapeDetails=false) fill org from the card's agency badge when the card shows one and emit the other lead keys empty with leadAbsences noting 未验证.

Field	Type	Meaning
`phones`	`[{value, type}]`	Not provided by the current page channel: always empty, on search and detail items alike. Idealista only shows phones after a click-reveal, which this Actor does not perform.
`emails`	`[{value, type}]`	Contact emails. Always empty on Idealista — all email contact is gate-locked behind a chat/lead form. See `leadAbsences.emails`.
`address`	`{street, unit, locality, region, postalCode, country, full}`	Property address. `unit` is the door number (门牌). Detail pages expose street + door number from `.header-map-list`; SRP cards show street only. Some listings privacy-hide the exact address.
`geo`	`{lat, lng}`	Coordinates from the inline script / `mapConfig` on detail pages. Null on SRP-only items.
`person`	`{name, role}`	Individual agent/seller name. Always null on Idealista — only agency/professional labels are shown, no personal name. See `leadAbsences.person`.
`org`	`{name, id}`	Agency/professional name (`.about-advertiser-name`) and slug. Present on detail items; null on SRP-only items.
`web`	`{website, socials[]}`	Agency website and social links. Always `{website: null, socials: []}` on Idealista — agency profile pages do not expose the agency's own website or socials. See `leadAbsences.web`.
`leadSource`	enum	Where the lead was captured: `search` (SRP card), or `detail` (detail page).
`leadReveal`	enum	How the lead was revealed: `visible` (directly visible), `click` (click-show button), `xhr` (XHR-after-click), `gated` (login/form wall), `absent` (not available on this surface).
`leadAbsences`	object	Maps missing lead sub-fields to reasons: `本站无` (site doesn't expose it), `闸门锁` (gate-locked behind login/form), `未验证` (not verified this run).

Reveal cost

Phones: not collected. Idealista hides phones behind a click-reveal, which the current page channel does not run, so phones is always empty.
Detail enrichment: when scrapeDetails=true (default ON), each listing opens its detail page, adding page-fetch time per item. Disable scrapeDetails for faster, cheaper SRP-card-only runs (but lead keys will be empty with 未验证 absences).
Proxy: Idealista uses DataDome; the backend uses a market-matched exit (ES/IT/PT). No proxy input is needed or accepted.

Honest limitations

The following leads are not available on Idealista and will always be empty or null with a documented leadAbsences reason:

Lead	Reason	`leadAbsences` value
Emails	Gate-locked behind a chat/lead form ("Contatta via chat" / "Contactar por chat"). No `mailto:` or plain-text email on any surface.	`闸门锁`
Person name	Idealista shows only agency/professional names, not individual agent names.	`本站无`
Agency website / socials	Agency profile pages do not expose the agency's own website or social media links.	`本站无`
Address door number (some)	Some listings privacy-hide the exact door number ("Por privacidad" / "Per privacy").	`未验证`
Geo (SRP-only)	Coordinates are only on detail pages (inline script).	`未验证`
Phones	Only shown after a click-reveal, which the current page channel does not run. Empty on every item.	`未验证`

Why scrape Idealista?

Idealista is one of Southern Europe’s largest property portals across Spain, Italy, and Portugal. Scraping Idealista listings helps with:

Cross-border market research and price benchmarking (Madrid, Barcelona, Roma, Lisboa…)
Lead generation for agencies, mortgage brokers, and service providers
Investment screening across sale and rental inventory
Monitoring new Idealista listings, price drops, and agency coverage
Feeding dashboards, CRMs, spreadsheets, or AI agent workflows

More Actors like this

Looking for another property portal, or a scraper outside real estate? Use a specialized Actor when one exists — structured fields, better coverage, usually lower cost. Use this Actor for Idealista sale / rent listings across Spain, Italy, and Portugal.

Similar real estate Actors

Prefer another specialized scraper?

Jobs & Freelance

E-commerce

Travel & Stays

Social & Content

Ads Intelligence

Local & Maps

Google Maps Scraper

General Tools

→ See the full catalog in Related Actors below, or browse apify.com/lentic_clockss.

How to scrape Idealista property data

Open this Actor and click Try for free (or Start).
Set country to ES, IT, or PT (or paste Idealista startUrls — the host infers the market).
Set location (for example madrid-madrid, roma-roma, lisboa) or provide search URLs.
Choose channel: BUY for sale or RENT for to-rent.
Set maxItems and maxPages for a small test first.
Enable scrapeDetails when you need agency names, full descriptions, and media from detail pages.
Click Start, then download the Dataset as JSON, CSV, Excel, or JSONL.

Example input (Spain — Madrid for sale)

{
  "country": "ES",
  "location": "madrid-madrid",
  "channel": "BUY",
  "propertyType": "homes",
  "maxItems": 10,
  "maxPages": 1,
  "scrapeDetails": true
}

Example input (Italy — Roma for sale)

{
  "country": "IT",
  "location": "roma-roma",
  "channel": "BUY",
  "propertyType": "homes",
  "maxItems": 5,
  "maxPages": 1,
  "scrapeDetails": false
}

Example input (Portugal — Lisboa to rent)

{
  "country": "PT",
  "location": "lisboa",
  "channel": "RENT",
  "propertyType": "homes",
  "maxItems": 5,
  "maxPages": 1,
  "scrapeDetails": false
}

Idealista markets and URL patterns

Country	Host	BUY path	RENT path	Detail path	Default location
ES	`idealista.com`	`/venta-*`	`/alquiler-*`	`/inmueble/{id}/`, `/obra-nueva/{id}/`	`madrid-madrid`
IT	`idealista.it`	`/vendita-*`	`/affitto-*`	`/immobile/{id}/`	`roma-roma`
PT	`idealista.pt`	`/comprar-*`	`/arrendar-*`	`/imovel/{id}/`	`lisboa`

Business-transfer searches omit the buy/rent prefix: /traspasos/, /cessione-attivita/, /trespasse/.

Run one Idealista country per Actor run. Mixing .com / .it / .pt URLs in the same input is rejected.

Property types (`propertyType`)

Logical aliases work in every market: homes, new_homes, rooms, garages, storage, offices, commercial, land, buildings, holiday, business_transfer.

Market	Local path segments
ES	`obranueva`, `viviendas`, `habitacion`, `garajes`, `trasteros`, `oficinas`, `locales`, `terrenos`, `edificios`, `vacacional`, `traspasos`
IT	`nuove_costruzioni`, `case`, `stanze`, `garage`, `cantine`, `uffici`, `negozi`, `terreni`, `edifici`, `case_vacanze`, `cessione-attivita`
PT	`empreendimentos`, `casas`, `quarto`, `garagens`, `arrecadacoes`, `escritorios`, `lojas_ou_armazens`, `terrenos`, `predios`, `trespasse`

Notes:

Room types (habitacion / stanze / quarto) are rent-only; channel=BUY is coerced to RENT.
Portugal “Para férias” on the homepage redirects to Rentalia (external); use ES vacacional / IT case_vacanze for on-site holiday inventory.
You can always paste a category search URL in startUrls instead of setting propertyType.

Example input (Spain — storage / trasteros)

{
  "country": "ES",
  "location": "madrid-madrid",
  "channel": "BUY",
  "propertyType": "storage",
  "maxItems": 5,
  "maxPages": 1,
  "scrapeDetails": false
}

Example input (Italy — commercial / negozi)

{
  "country": "IT",
  "location": "roma-roma",
  "channel": "RENT",
  "propertyType": "commercial",
  "maxItems": 5,
  "maxPages": 1,
  "scrapeDetails": false
}

Input

Field	Description
`country`	`ES`, `IT`, or `PT`. Inferred from `startUrls` host when present.
`startUrls`	Idealista search or detail URLs. Overrides built search URLs when set. No default: leave empty to search by `country` + `location`.
`location`	Idealista location path such as `madrid-madrid`, `roma-roma`, `lisboa`. Empty uses the market default. Used only when `startUrls` is empty.
`channel`	`BUY` or `RENT` (mapped to local Idealista path prefixes).
`propertyType`	Local path segment or logical alias (see table above).
`maxItems`	Most listing rows for each start URL, or for the selected location when no URL list is supplied. Default 70; larger values are collected in parts of 70. Every row has `rowType: "listing"` and a stable string `id`; the run stops at your maximum total charge.
`maxPages`	Maximum search pages to crawl.
`scrapeDetails`	Open each Idealista detail page for enrichment.
`requestDelayMillis`	Delay between browser navigations (helps with DataDome).

Output example

{
  "id": "111396097",
  "url": "https://www.idealista.com/inmueble/111396097/",
  "source": "idealista",
  "country": "ES",
  "sourceLayer": "srp+ldp",
  "channel": "BUY",
  "propertyType": "viviendas",
  "title": "Piso en venta en Calle de Castelló",
  "priceAmount": 1490000,
  "rooms": 2,
  "livingSpace": 106,
  "agencyName": "Única Consultoría Inmobiliaria",
  "images": ["https://img4.idealista.com/..."],
  "scrapedAt": "2026-07-18T05:44:53+00:00"
}

Output example (detail item with lead keys)

When scrapeDetails=true, each item includes the full lead-key set:

{
  "id": "111396097",
  "url": "https://www.idealista.com/inmueble/111396097/",
  "source": "idealista",
  "country": "ES",
  "sourceLayer": "srp+ldp",
  "channel": "BUY",
  "title": "Piso en venta en Calle de Castelló",
  "priceAmount": 1490000,
  "agencyName": "Única Consultoría Inmobiliaria",
  "phones": [],
  "emails": [],
  "address": {
    "street": "Calle de Castelló",
    "unit": "3",
    "locality": "Madrid",
    "region": "Madrid",
    "postalCode": "28001",
    "country": "ES",
    "full": "Calle de Castelló, 3, Madrid, Madrid"
  },
  "geo": {"lat": 40.4256, "lng": -3.6907},
  "person": null,
  "org": {"name": "Única Consultoría Inmobiliaria", "id": "unica-consultoria-inmobiliaria"},
  "web": {"website": null, "socials": []},
  "leadSource": "detail",
  "leadReveal": "visible",
  "leadAbsences": {
    "phones": "未验证",
    "emails": "闸门锁",
    "person": "本站无",
    "web": "本站无"
  },
  "scrapedAt": "2026-08-19T13:30:37+00:00"
}

Pricing

This Actor uses Pay per event pricing:

Event	Price
Actor start (`apify-actor-start`)	$0.005 per start
Result (`apify-default-dataset-item`)	$2.50 / 1,000 results (`$0.0025` each)

Platform usage costs are paid by the user (compute, storage). Actor compute is light since acquisition happens on the backend worker; no Apify proxy is used.

Free Apify plan limits (set by this Actor's developer)

Limit	Free Apify plan	Paid Apify plan
Runs of this Actor	10 runs total	Unlimited
Rows per run	Up to 200	Stops at your maximum total charge

When the run cap is hit, the run finishes with a clear status message — not an Apify platform error. These limits are set by the Actor developer, not Apify.

Worker host migrations: update Actor env WORKER_BASE_URL (and WORKER_AUTH if the API key changed) — no Actor code change required.

Idealista scraping tips for better results

Start with maxItems=3–10 and maxPages=1 to validate location and proxy.
Match proxy country to the Idealista market (ES / IT / PT).
Keep a non-zero requestDelayMillis (for example 3000–4000) for DataDome stability.
Prefer search URLs from the live Idealista site when a location path is unclear.
Use scrapeDetails=true only when you need agency / media enrichment (higher runtime and proxy use).
Do not mix Spain, Italy, and Portugal URLs in one run.

Live View / standby endpoints

When the Actor runs in standby / Live View mode, these operational endpoints are available:

Method	Path	Purpose
`GET`	`/`	Service info
`GET`	`/health`	Health check
`GET`	`/input-example`	Low-cost input example
`GET`	`/openapi.json`	Deployed OpenAPI document

Scraping still runs through a normal Actor run (not these standby endpoints).

Is it legal to scrape Idealista?

Scraping publicly available Idealista listing data for research, market analysis, or internal business intelligence is commonly done, but you must follow Idealista’s terms, local law, and privacy rules. Do not scrape personal data you are not allowed to process, and respect robots / rate limits. This Actor is provided as a technical tool; you are responsible for lawful use.

FAQ

Can I scrape Idealista Spain, Italy, and Portugal with one Actor?

Yes. Set country to ES, IT, or PT, or paste URLs from idealista.com, idealista.it, or idealista.pt. Run one country per job.

Is this an Idealista API?

No. Idealista does not offer a public listing API for this use case. This Actor is an Idealista API alternative that extracts data from Idealista search and detail pages.

Do I need to configure a proxy?

No. Idealista uses DataDome and direct / datacenter HTTP often returns 403, so the backend fetches pages through a market-matched exit. The Actor has no proxy input.

What is the difference between `scrapeDetails=false` and `true`?

false is faster and cheaper: Idealista search cards only. true opens each detail page for agency names, fuller descriptions, and media metadata.

Can I export Idealista data to Excel or CSV?

Yes. After the run finishes, download the Dataset as Excel, CSV, JSON, or JSONL from the Apify Console, or pull it via the Apify API.

How do I scrape Idealista rentals only?

Set channel to RENT (maps to /alquiler-*, /affitto-*, or /arrendar-* depending on country).

Why did my free-plan run stop after 10 runs?

This Actor allows 10 runs and up to 200 rows per run for free Apify plan users. That policy is set by the Actor developer (not Apify). Upgrade to a paid Apify plan for unlimited runs. The run ends with status message FREE_TIER_LIMIT — it is not a platform crash.

Support

If a run fails or returns empty results, check the run log for DataDome / proxy messages and open an Apify issue on this Actor with the run ID, country, location or startUrls, and whether scrapeDetails was enabled.

All 77 public Actors from [lentic_clockss]. Click a name to open the Store detail page.

Jobs & Freelance

Real Estate

E-commerce

Travel & Stays

Ads Intelligence

Local & Maps

Google Maps Scraper

General Tools

→ Browse the full profile: apify.com/lentic_clockss

Idealista | Spain |Italy| Portugal | Richest Output | PPE V2

memo23/idealista-scraper-rental

Extract comprehensive property data from Idealista.com: prices, locations, images, agent contacts, property features (rooms, bathrooms, amenities), detailed descriptions in multiple languages, and market insights. Perfect for real estate analysis, investment research, and market monitoring across EU

Muhamed Didovic

5.0

(2)

Argenprop Property Search Scraper

ecomscrape/argenprop-property-search-scraper

Automate property data extraction from Argenprop.com, Argentina's leading real estate platform with 350,000+ listings. Extract property details, prices, addresses, images, and descriptions from apartments, houses, and commercial properties efficiently for market analysis and business intelligence.

ecomscrape

Idealista Scraper API — Spain, Italy & Leads

pro100chok/idealista-scraper

Idealista scraper and unofficial Idealista API for Spain, Italy and Portugal — homes, offices, garages, land, sale or rent. 60+ fields per listing: price, €/m², size, rooms, amenities, energy rating, GPS + province/city/district, photos, plans, videos, 3D tours, agency contacts. From $0.70/1k.

Raven

Immosuchmaschine.at Scraper

lexis-solutions/immosuchmaschine-at-scraper

Scrape Immosuchmaschine.at (Austria) real estate listings – rental and sale apartments and houses – with this Austrian property web scraper for market research, lead generation, housing analytics and price tracking.

Lexis Solutions

Idealista Property Listing Scraper

crabwalker/idealista-property-listing-scraper

Scrape an Idealista property listing (single URL)

Crab Walker

Idealista Scraper API

dz_omar/idealista-scraper-api

💰 $0.5 per 1,000 results. Scrape Idealista properties & listings from Spain (.com), Portugal (.pt) & Italy (.it). Supports property URLs + search/listing URLs. Fast mobile API extraction with real-time NDJSON streaming. Standby mode for instant responses.

FlowExtract API

1.4K

4.9

(19)

Zumper Scraper - Sales & Rental Listings

lentic_clockss/us-real-estate-scraper

Scrape US real estate listings from Zumper (rentals). Export prices, beds, baths, sqft, photos, amenities, and location fields for market research.

kane liu

Wikicasa Property Search Scraper

stealth_mode/wikicasa-property-search-scraper

Scrape comprehensive property listings from Wikicasa.it with 45+ fields per property. Collect prices, specifications, images, floor plans, agency details, and auction information — perfect for real estate professionals, investors, and market researchers.

Stealth mode