Idealista Scraper — Spain Listings & Agency Leads

Disclaimer: This is an unofficial integration developed independently. It is not affiliated with, sponsored by, or endorsed by Idealista or any of its subsidiaries.

Idealista and related names are trademarks of their respective owners. Data is read from publicly accessible Idealista Spain pages. No Idealista account login is required.

This Actor is provided for informational, research, lead-generation, and market monitoring purposes. You are solely responsible for complying with applicable laws (including GDPR), Idealista's terms of use, and your organization's policies when processing personal data such as agency phone numbers.

Scrape Idealista Spain (idealista.com) into clean JSON: sale and rent listings with price, €/m², rooms, size, floor, energy labels, photos, GPS, and optional inmobiliaria / agency enrichment (office address, active ads, website, revealed phones). Use it as an Idealista API alternative from Python, Node.js, cURL, or Apify MCP / AI assistants — paste any search, /inmueble/, or /pro/ URL.

Best for: Spain market comps, PropTech pipelines, agency lead lists, rent/sale monitoring, and dataset export (JSON / CSV) via Apify.

Actor	Role
Idealista Scraper ◄── you are here	Spain Idealista listings + agency leads
Kleinanzeigen Scraper	German classifieds + monitor alerts
Marktplaats Scraper	Dutch marketplace listings
mobile.de Scraper	German vehicle listings

When to use this Actor

• Idealista scraper for Spain search pages — Copy a filtered browser URL (city, district, price, typology) into Start URLs.
• Agency / inmobiliaria lead generation — Enable agency enrichment to pull office address and contact phones from /pro/ profiles.
• Full Idealista listing details — Switch to details mode for description, feature blocks, energy certificate letters, and photo gallery URLs.
• Coverage past the SERP pagination cap — Keep auto price-chunking on for cities with thousands of ads (Madrid, Barcelona, Valencia…).
• Scheduled Idealista monitoring — Re-run the same search on Apify schedules and export deltas into your CRM or warehouse.

When not to use this Actor

• Italy / Portugal Idealista TLDs — This Actor targets idealista.com (Spain) first; IT/PT paths are not the primary path.
• Authenticated Idealista actions — No login, messaging, or private alerts inbox.
• Datacenter-only proxies — Idealista uses DataDome; Apify Residential ES is required for stable runs.

Key features

• Camoufox + Residential ES — Anti-detect browser session tuned for DataDome.
• Listings or full details — Fast SERP cards, or full /inmueble/ enrichment.
• Agency intelligence — Optional /pro/ profile parse + phone reveal.
• Smart price chunking — Splits oversized searches into EUR bands and subdivides when a band still exceeds the soft cap.
• Flexible inputs — Start URLs, or form fields (locationSlug + operation + property type).
• Apify-native export — Dataset items ready for JSON/CSV and downstream Actors.

Input

Parameter	Type	Default	Description
startUrls	Array	Madrid search	Idealista search, /inmueble/, or /pro/ URLs
operation	String	sale	Form search: sale / rent
propertyType	String	homes	Form search typology
locationSlug	String	madrid-madrid	Form search location path
runMode	String	listings	listings or details
enrichAgency	Boolean	false	Visit agency profile + reveal phones
maxItems	Integer	5	Max listings to return
maxPagesPerUrl	Integer	1	SERP pages per chunk
autoChunk	Boolean	true	Split large searches by price
minPrice / maxPrice	Integer	—	Optional EUR bounds
concurrency	Integer	1	Keep low under DataDome
proxyConfiguration	Object	Residential ES	Required — country ES

Input example

{
  "startUrls": [
    { "url": "https://www.idealista.com/venta-viviendas/madrid-madrid/" }
  ],
  "runMode": "details",
  "enrichAgency": true,
  "maxItems": 50,
  "maxPagesPerUrl": 3,
  "autoChunk": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "ES"
  }
}

Output

Each dataset item is one Idealista listing (or a direct agency row).

Field	Description
id / url / title	Property code, canonical URL, title
operation / propertyType	sale/rent and typology
price / priceByArea / currency	Asking price and €/m² when shown
sizeM2 / rooms / bathrooms / floor	Size and layout
hasLift / hasParking / hasTerrace / hasPool	Amenity flags when detectable
status / energyEfficiency	Condition + energy letter scales
location	Country/city/district/neighborhood/address/coords
description / photos / features	Detail-mode rich fields
agency.*	Name, slug, URL, phone(s), office address, website, active count

Output example

{
  "id": "107189198",
  "url": "https://www.idealista.com/inmueble/107189198/",
  "title": "Piso en venta en Calle de María de Molina, Lista, Madrid",
  "operation": "sale",
  "propertyType": "homes",
  "price": 2415000,
  "currency": "EUR",
  "priceByArea": 7944,
  "sizeM2": 304,
  "rooms": 5,
  "bathrooms": 3,
  "floor": "2ª planta exterior",
  "hasLift": true,
  "hasParking": true,
  "location": {
    "country": "ES",
    "city": "Madrid",
    "neighborhood": "Lista",
    "address": "Calle de María de Molina"
  },
  "agency": {
    "agencyName": "Gilmar Barrio de Salamanca",
    "agencySlug": "gilmarsalamanca",
    "agencyUrl": "https://www.idealista.com/pro/gilmarsalamanca/",
    "address": "Diego de León 15, Madrid, 28006",
    "activeListingsCount": 48,
    "phone": "+3491..."
  }
}

Use cases

• Build Spain sale/rent comps for a district with full photo sets and €/m².
• Generate inmobiliaria outreach lists (office address + phone) for CRM import.
• Monitor new Idealista listings under a price ceiling with scheduled Apify runs.
• Feed PropTech valuation or yield models from structured Idealista fields.
• Compare Idealista Spain inventory with other EU marketplaces (see siblings below).

Integration examples

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/idealista-scraper').call({
  startUrls: [{ url: 'https://www.idealista.com/venta-viviendas/barcelona-barcelona/' }],
  runMode: 'listings',
  maxItems: 100,
  proxyConfiguration: {
    useApifyProxy: true,
    apifyProxyGroups: ['RESIDENTIAL'],
    apifyProxyCountry: 'ES',
  },
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 5));

Python

from apify_client import ApifyClient

client = ApifyClient()
run = client.actor("crawloop/idealista-scraper").call(
    run_input={
        "startUrls": [
            {"url": "https://www.idealista.com/venta-viviendas/valencia-valencia/"}
        ],
        "runMode": "details",
        "enrichAgency": True,
        "maxItems": 25,
        "proxyConfiguration": {
            "useApifyProxy": True,
            "apifyProxyGroups": ["RESIDENTIAL"],
            "apifyProxyCountry": "ES",
        },
    }
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("id"), item.get("price"), (item.get("agency") or {}).get("agencyName"))

cURL

curl -X POST "https://api.apify.com/v2/acts/crawloop~idealista-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "startUrls": [{"url": "https://www.idealista.com/venta-viviendas/madrid-madrid/"}],
    "runMode": "listings",
    "maxItems": 20,
    "proxyConfiguration": {
      "useApifyProxy": true,
      "apifyProxyGroups": ["RESIDENTIAL"],
      "apifyProxyCountry": "ES"
    }
  }'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call this Actor by its Store ID / name (crawloop/idealista-scraper).

Example prompts:

• "Run Idealista Scraper for venta viviendas in Madrid and return the top 20 rows as JSON with price, m², and neighborhood"
• "Scrape Idealista Barcelona rentals under €1,500 with agency enrichment and summarize phone coverage"
• "Pull Idealista listing details for these /inmueble/ URLs, then suggest how to compare with Kleinanzeigen Scraper for DE inventory"

Suite next step

After Idealista Spain comps, expand EU classifieds coverage with Kleinanzeigen Scraper (DE monitor + alerts) or Marktplaats Scraper for NL marketplace data.

FAQ

Is this an Idealista API?
No. It is an unofficial Idealista scraper / API alternative that reads public Spain pages and returns structured dataset items. It is not affiliated with Idealista.

Why do I need residential proxies?
Idealista protects pages with DataDome. Datacenter IPs are usually challenged; Apify Residential with apifyProxyCountry: "ES" is the supported setup.

What is auto price-chunking?
When a search reports more results than Idealista will paginate, the Actor splits the query into EUR bands (and subdivides oversized bands) so you can collect beyond a single SERP window.

Does enrichAgency collect private seller phones?
Enrichment targets agency /pro/ profiles. Private advertisers typically have no agency URL; those rows stay without agency.phone.

Can I scrape Idealista with Python or Node.js?
Yes — use the Apify client examples above, or call the Actor from MCP / AI assistants.

Related Actors

Actor	Notes
Idealista Scraper ◄── you are here	Spain listings + agency leads
Kleinanzeigen Scraper	German classifieds monitor
Marktplaats Scraper	Dutch marketplace listings
mobile.de Scraper	German vehicle listings
eBay Sold Listings Scraper	Sold comps across eBay sites