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.

Idealista Listings Exporter · Chrome extension — Idealista ES/IT/PT search to CSV/JSON
	Idealista Listings Exporter ↗ One-click CSV/JSON in your browser · free 200 listings / month Install free → · Edge

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

• Quick browser export (CSV/JSON) — For one-off exports from the page you are viewing, use Idealista Listings Exporter (Chrome · Edge) instead of a cloud run.
• Italy / Portugal Idealista TLDs — This Actor targets idealista.com (Spain) first; for IT/PT search exports in-browser, use the same extension (idealista.it, idealista.pt).
• Authenticated Idealista actions — No login, messaging, or private alerts inbox.
• Datacenter-only proxies — Idealista uses DataDome; Apify Residential ES is required for stable runs.

Idealista Listings Exporter (browser extension)

Idealista Listings Exporter turns Idealista search results into clean CSV or JSON — in one click.

Built for real-estate agents, investors, and analysts who need structured listing data from Idealista Spain, Italy, and Portugal. Export runs in your browser session: no account on our servers, no proxies, no copy-paste.

Install free → · Edge · Free tier: 200 listings / month

Who it’s for

• Real-estate agents building comps and prospect lists
• Investors screening sale & rent inventory
• Analysts who need Idealista data in Excel, Sheets, or BI tools

What you get

• Export search results from the page you’re viewing
• Multi-page export (fetch more results with your Idealista session)
• CSV (Excel-ready) or JSON
• Filters before export: agency vs private, minimum price, minimum m²
• Fields agents actually use: price, €/m², size, rooms, bathrooms, floor, garage included, agency name, location, listing URL, and more

How to use

1. Install the extension (Chrome or Edge)
2. Open an Idealista search (e.g. homes for sale in Madrid)
3. Click Export listings (or use the toolbar popup)
4. Choose pages, filters, and CSV or JSON — download starts

Supported sites

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

Free tier & privacy

• Export up to 200 listings per month for free; remaining quota is shown in the extension
• No signup required to start
• Listing data is parsed and downloaded locally in your browser
• We do not require login to our servers for the free exporter
• Works with your existing Idealista session

Actor vs extension: use this Apify Actor for scheduled Spain pipelines, agency enrichment, and large automated datasets; use Idealista Listings Exporter when you want an instant CSV/JSON download from Idealista in Chrome or Edge.

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.

Is there a browser extension for Idealista export?
Yes — Idealista Listings Exporter exports Idealista search results to CSV/JSON in one click (Spain, Italy, Portugal), with a free tier of 200 listings / month. Install from Chrome Web Store or Microsoft Edge Add-ons.

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

For a structured overview of inputs, output fields, API examples, and workflows, see the Idealista Scraper guide on Crawloop.