Idealista Scraper: Spanish Real Estate Listings & Prices (Sale or Rent)

Scrape Idealista property listings and prices across Spain in one run. Idealista is Spain's #1 real estate portal. Built for property investors, price research, and market analysis: fast, reliable, and returned as clean structured JSON. Runs with defaults and works as an MCP tool for AI agents.

What it does

Give it a location slug and choose sale or rent. It returns every property listing as a structured record you can build on:

• Sale or rent in one actor: switch filters.operation between venta-viviendas (for sale) and alquiler-viviendas (for rent)
• Target any Spanish market by location slug (madrid-madrid, barcelona-barcelona, and more)
• Structured price, size in m², rooms, floor, and lift data for every listing
• Reliable through Idealista's DataDome anti-bot protection
• Stable JSON schema: safe to depend on in code and pipelines
• Runs with defaults and MCP-ready: no setup needed, and AI agents can call it as a tool

Input

query is a location slug, not a search keyword: it is the Spanish city or district exactly as it appears in an idealista.com URL (for example madrid-madrid or barcelona-barcelona). Set filters.operation to venta-viviendas to scrape properties for sale, or alquiler-viviendas to scrape rentals.

Field	Type	Default	Description
query	string	"madrid-madrid"	Location slug (not a keyword): the city or area to scrape, e.g. madrid-madrid, barcelona-barcelona.
countries	array	["es"]	Spain only. Idealista is a Spain-only portal, so this stays ES.
maxItems	integer	100	Max listings returned.
filters	object	{ "operation": "venta-viviendas" }	Catalog filters. The key one is operation: venta-viviendas for sale (default) or alquiler-viviendas for rent.
proxyConfiguration	object	Residential ES	Apify residential proxy located in Spain, required to pass Idealista's DataDome protection.

Example input

{
  "query": "madrid-madrid",
  "maxItems": 100,
  "filters": { "operation": "alquiler-viviendas" }
}

Output

Each property is one dataset record:

{
  "id": "10....",
  "url": "https://www.idealista.com/inmueble/10..../",
  "title": "Piso en calle de Example, Ciudad Jardín, Madrid",
  "price": { "amount": 1250000, "currency": "EUR" },
  "size": "154 m²",
  "category": "Piso",
  "country": "es",
  "location": { "city": "Madrid", "region": "Ciudad Jardín" },
  "rooms": 4,
  "floor": "4ª",
  "hasLift": true,
  "images": ["https://img4.idealista.com/....webp"],
  "isBusinessSeller": true,
  "scrapedAt": "2026-07-10T12:00:00+00:00"
}

Optional fields appear only when they exist on a listing, so rooms, floor, hasLift, and isBusinessSeller may be absent on some records.

Field notes:

• price is the total asking price for sale, and the monthly rent when operation is alquiler-viviendas.
• category is the property type: Piso, Ático, Casa, Estudio, and similar.
• location.region carries the neighbourhood or zone within the city.
• rooms is the bedroom count (absent for studios).
• floor and hasLift reflect Spanish-market purchase concerns: which floor the flat is on, and whether the building has a lift.
• isBusinessSeller marks agency listings (true) versus private sellers (false).

Use cases

• Investment sourcing: find undervalued flats by comparing price per m² across districts
• Rental yield analysis: pull sale and rent prices for the same area to estimate gross yield
• Market research: track supply, asking prices, and property mix across Spanish cities
• AI agents: a reliable data tool an agent can call to answer "what do 3-bed flats cost in Barcelona?"

Pricing

Pay per result: you're charged per property returned, so you only pay for data you actually get. See the exact per-event price on this Actor's page.

Fair use & privacy

Reads public listings only: no login and no account cookies. Personal seller or agent contact details are not collected (GDPR-friendly): the output contains property listing data, not people.