Idealista Scraper icon

Idealista Scraper

Scrape property listings from Idealista (Spain, Italy, Portugal) via Apify

Actions2

Rent

AI-generated

Summary

Scrapes Idealista property listings for rent in a selected country and location, applying detailed filters and returning matching property records.

Inputs

  • country — Idealista country domain to search (Spain, Italy, Portugal)
  • operation — Type of listing to search for; set to "rent" for rental results
  • endpoint — Property category to search (e.g., homes, commercial properties)
  • locationId (required) — Idealista location code (e.g., "0-EU-ES-28-07-001-079")
  • locationName (required) — Human‑readable location name (e.g., "Madrid")
  • numPages — Number of pages to scrape (each ~40 properties; default 1)
  • order — How to sort results (e.g., "mostrecent", "highestprice")
  • language — Language for property descriptions (e.g., "es", "en")
  • priceFilters — Price range filters (minPrice, maxPrice)
  • sizeFilters — Size range filters (minSize, maxSize)
  • bedroomBathroomFilters — Bedroom and bathroom inclusion/exclusion filters
  • propertyTypeFilters — Property type inclusion filters (flat, house, etc.)
  • conditionFilters — Condition and occupancy filters (e.g., furnished, new development)
  • featureFilters — Feature inclusion filters (e.g., elevator, garage)
  • floorTimeFilters — Floor and publication‑date filters (e.g., topFloor, sinceDate)
  • rentalFilters — Rental‑specific filters (longTermResidential, shortTerm)
  • advancedFilters — Advanced filters such as agency, GPS coordinates, search radius
  • timeout — Maximum seconds to wait for scraping (default 300)
  • maxResults — Maximum number of properties to return (0 = all)

Output shape

array of property records (each representing a scraped listing)

Returns scraped property data; may include items with errors; pagination not enforced by node but limited by maxResults and numPages.

Examples

Example 1: Scrape rent listings for apartments in Madrid, Spain, up to 5 pages, sorted by most recent.

country: es; operation: rent; endpoint: listhomes; locationId: 0-EU-ES-28-07-001-079; locationName: Madrid; numPages: 5; order: mostrecent; language: es; priceFilters: {minPrice: 500, maxPrice: 1500}; sizeFilters: {minSize: 50}; bedroomBathroomFilters: {bedrooms1: true}; timeout: 600; maxResults: 0

Example 2: Filter for newly built luxury rentals in Lisbon, Portugal, limited to 2 results.

country: pt; operation: rent; endpoint: listnewhomes; locationId: 0-EU-PT-16-01-001-001; locationName: Lisbon; propertyTypeFilters: {villaType: true, penthouse: true}; conditionFilters: {newDevelopment: true, luxury: true}; maxResults: 2; timeout: 900

Example 3: Search for commercial rentals in Rome using GPS radius, returning only 10 results.

country: it; operation: rent; endpoint: listcommercialproperties; locationId: 0-EU-IT-12-03-015-123; locationName: Rome; advancedFilters: {center: "41.9028,12.4964", distance: 5000}; rentalFilters: {shortTerm: true}; maxResults: 10; timeout: 600

Links

Discussion