Scrape Idealista Property Listings with Filters, Details, Images, and Pagination

Other languages: Translated versions are available at the bottom of this README: Italiano, Español, Português, and Français.

Extract real estate listings from Idealista in Spain, Italy, Portugal, and France. This Actor is built for property researchers, investors, agencies, analysts, and data teams that need structured Idealista data without manually copying listings page by page.

Use it to collect prices, locations, property details, images, descriptions, and listing URLs from Idealista search pages or individual property pages.

Why use this Actor?

Tired of manually checking Idealista listings, copying prices into spreadsheets, or losing track of market changes across cities and neighborhoods?

This Actor turns Idealista pages into clean, structured JSON that you can export, analyze, or connect to your existing workflows.

Key benefits

• Scrape many listings in one run instead of manually opening every result page.
• Start from an Idealista URL and keep the same country, location, property type, and filters you already selected on the website.
• Collect property details and media such as price, size, rooms, bathrooms, address, location, description, images, and listing URL.
• Search by city or area when you do not already have an Idealista URL.
• Filter results by price, size, rooms, bathrooms, photos, floor plan, elevator, garage, heating, air conditioning, and more.
• Export data easily from Apify datasets to JSON, CSV, Excel, Google Sheets, databases, or APIs.
• Schedule recurring runs to monitor new listings, price changes, and market inventory automatically.

What data can you extract?

Depending on the listing and selected options, the Actor can extract:

• Property ID and property code
• Idealista listing URL
• Country
• Sale or rent operation
• Property type
• Price and currency
• Size
• Number of rooms
• Number of bathrooms
• Address
• Municipality / city
• Province / region
• Latitude and longitude when available
• Description
• Thumbnail image
• Additional images and media when enabled
• Contact-related metadata when available
• Property features
• Similar recommended properties when enabled
• Source URL
• Scrape timestamp
• Error message for failed records

Features, advantages, and benefits

Feature	Advantage	Benefit
Search URL support	Paste an Idealista search page directly	Reuse filters you already selected on Idealista without rebuilding the search manually
Individual property URL support	Scrape a single listing page	Quickly enrich one property with structured data
Automatic pagination	Collects multiple result pages up to your limit	Scrape large result sets without manually handling pages
Location search	Search by country, operation, property type, and city/area	Build searches even when you do not have an Idealista URL
Price and size filters	Narrow results by budget and property dimensions	Focus only on listings that match your criteria
Room and bathroom filters	Target specific residential property requirements	Save time when monitoring homes or apartments
Optional detail extraction	Opens listings for richer information	Get more complete records when search results are not enough
Optional multimedia extraction	Collects extra images and media when available	Build richer property databases and visual dashboards
Recommended properties option	Includes similar properties when available	Discover comparable listings for market analysis
Configurable result limit	Control how many listings are saved per query	Manage cost, speed, and dataset size

Example output

{
  "id": "35585970",
  "propertyCode": "35585970",
  "url": "https://www.idealista.it/immobile/35585970/",
  "country": "it",
  "operation": "sale",
  "propertyType": "chalet",
  "price": 37000,
  "currency": "EUR",
  "size": 172,
  "rooms": 6,
  "bathrooms": 2,
  "address": "Detached house in Località Scabbiabella, 24, Torriglia",
  "municipality": "Torriglia",
  "province": "Genova",
  "latitude": 44.5184183,
  "longitude": 9.1172171,
  "description": "Scabbiabella – Semi-detached two-level house...",
  "thumbnail": "https://img4.idealista.it/...",
  "multimedia": {
    "images": [
      {
        "url": "https://img4.idealista.it/...",
        "tag": "views"
      },
      {
        "url": "https://img4.idealista.it/...",
        "tag": "corridor"
      }
    ]
  },
  "features": {
    "hasSwimmingPool": false,
    "hasTerrace": true,
    "hasAirConditioning": false,
    "hasBoxRoom": false,
    "hasGarden": false
  },
  "sourceUrl": "https://www.idealista.it/en/vendita-case/genova-provincia/",
  "scrapedAt": "2026-07-11T14:14:42.211Z",
  "status": "success"
}

How to use

Option 1: Scrape from Idealista URLs

Use this when you already have a search page or property page open in your browser.

1. Open Idealista.
2. Apply the filters you need.
3. Copy the search results URL or listing URL.
4. Paste it into Idealista URLs.
5. Set Maximum results per query.
6. Run the Actor.

Example input:

{
  "startUrls": [
    {
      "url": "https://www.idealista.it/vendita-case/genova-provincia/"
    }
  ],
  "maxResults": 100,
  "includeDetails": true,
  "includeMultimedia": true
}

Option 2: Search by location

Use this when you do not have an Idealista URL and want to search by country and area.

Example input:

{
  "country": "it",
  "operation": "sale",
  "propertyType": "homes",
  "locationQuery": "Genova",
  "maxResults": 100,
  "minPrice": 100000,
  "maxPrice": 400000,
  "minRooms": 2,
  "includeDetails": true
}

Input options

Search source

Input	Description	Example
startUrls	Idealista search result URLs or individual property URLs. Best option when you already selected filters on Idealista.	https://www.idealista.it/vendita-case/genova-provincia/
country	Country for location searches. Used when startUrls is empty.	it
operation	Choose sale or rent for location searches.	sale
propertyType	Property type to search for.	homes
locationQuery	City, town, neighborhood, or area name.	Genova
locationIds	Advanced option for users who already know Idealista location IDs.	["0-EU-IT-08-000-000001"]
locationSelectionMode	How to choose location matches: best match, all matches, or exact match only.	best

Supported country values:

• es — Spain
• it — Italy
• pt — Portugal
• fr — France

Supported property type values:

• homes
• offices
• premises
• garages
• lands
• buildings
• rooms
• newDevelopments

Result settings

Input	Description	Default
maxResults	Maximum number of properties to save for each URL or location search.	100
includeDetails	Collect richer information from each property page. Slower, but more complete.	false
includeMultimedia	Collect extra photos and media when available.	false
includeRecommendations	Collect similar recommended properties when available.	false

Price and size filters

These are mainly used for location searches. If you use an Idealista URL, filters are usually taken from the URL itself.

Input	Description
minPrice	Minimum property price
maxPrice	Maximum property price
minSize	Minimum property size in square meters
maxSize	Maximum property size in square meters
minRooms	Minimum number of rooms
maxRooms	Maximum number of rooms
minBathrooms	Minimum number of bathrooms

Property filters

Input	Description
hasPhotos	Prefer listings with photos when supported
hasPlan	Include only listings with a floor plan when supported
exterior	Include only exterior-facing properties when supported
elevator	Include only properties with an elevator when supported
airConditioning	Include only properties with air conditioning when supported
garage	Include only properties with garage or parking when supported
heating	Include only properties with heating when supported
accessible	Include only accessible properties when supported
security	Include only properties with security features when supported

Advanced settings

Most users can keep these defaults.

Input	Description	Default
quality	Image/detail quality preference.	low
gallery	Include gallery images in search results when available.	true
order	Result ordering mode.	weigh
sort	Sort direction.	desc
itemsPerPage	Results requested per search page.	50
searchConcurrency	Number of search pages requested in parallel.	4
maxRetries	Number of retries for temporary failures.	3
requestTimeoutSeconds	Maximum time to wait for a request before retrying.	45
delaySeconds	Delay between search batches.	0
debug	Enable more detailed run logs.	false

Common use cases

• Market research — compare property prices across cities, neighborhoods, and property types.
• Price monitoring — track listings that match a budget or investment profile.
• Lead generation — collect structured property data for real estate workflows.
• Investment analysis — analyze price, size, location, and features at scale.
• Competitive intelligence — monitor available inventory in target regions.
• Inventory tracking — build datasets of active listings for internal dashboards.
• Location analysis — map listings using latitude and longitude when available.

Why this Actor

• Flexible search options: use either Idealista URLs or structured location searches.
• Clean output: records include normalized fields such as price, currency, size, rooms, bathrooms, address, coordinates, description, images, and source URL.
• Useful filters: narrow searches by price, size, rooms, property features, and more.
• Detail enrichment: optionally collect more complete property data and media.
• Multi-country support: works with Idealista pages in Spain, Italy, Portugal, and France.
• Ready for automation: export results to Apify datasets, APIs, spreadsheets, or downstream systems.
• Built for recurring monitoring: schedule the same search to run daily, weekly, or hourly and keep your property dataset fresh.

Automate Idealista monitoring with scheduled runs

One of the best ways to use this Actor is to run it on a schedule. Instead of checking Idealista manually, you can let Apify collect fresh data every day, every week, or as often as your workflow requires.

Scheduled workflow ideas

• Daily new-listing monitor — run the same Idealista search every morning and export the latest matching properties.
• Price monitoring — collect the same market repeatedly and compare prices over time.
• Investor watchlists — track properties in specific cities, neighborhoods, or price ranges.
• Agency inventory tracking — monitor available listings in your operating areas.
• Market reports — schedule weekly exports for dashboards, spreadsheets, or BI tools.
• Lead generation pipeline — send fresh listings into your CRM or database using Apify integrations.

How to schedule this Actor on Apify

1. Open the Actor on Apify.
2. Click Run and configure your input, such as an Idealista search URL, maxResults, and optional detail extraction.
3. Save the task after confirming the input works for your use case.
4. Open Schedules in Apify.
5. Create a new schedule and select the saved task.
6. Choose how often it should run, for example daily, weekly, or hourly.
7. Connect the dataset output to your preferred destination, such as Google Sheets, an API, Make, Zapier, or your own database.

Example scheduled setup

{
  "startUrls": [
    {
      "url": "https://www.idealista.it/vendita-case/genova-provincia/"
    }
  ],
  "maxResults": 200,
  "includeDetails": true,
  "includeMultimedia": false
}

Run this task every morning to build a recurring dataset of properties for sale in Genova. You can then compare datasets over time to detect new listings, removed listings, and price changes.

FAQ

Does this Actor require proxies?

For reliable scraping, proxies are recommended. The Actor includes proxy configuration in the input, and the default setup is suitable for most runs on Apify.

Can it scrape all pages from a search?

The Actor can paginate through search results up to the maxResults value you set. Very large searches may be limited by availability, website behavior, or the filters used.

Can I scrape a single property page?

Yes. Paste an individual Idealista property URL into startUrls and run the Actor.

Can I use filters from Idealista itself?

Yes. The easiest workflow is to apply filters on Idealista, copy the resulting URL, and paste it into startUrls.

Does it support multiple countries?

Yes. It supports Idealista pages for Spain (es), Italy (it), Portugal (pt), and France (fr).

Does it support rentals and sales?

Yes. For structured location searches, set operation to sale or rent. For URL searches, use the corresponding Idealista sale or rent URL.

Why are some fields empty?

Some listings do not provide every field. For example, coordinates, bathrooms, features, images, or contact-related data may be missing depending on the listing and selected options.

Should I enable includeDetails?

Enable includeDetails when you need richer property records. Keep it disabled when you want faster runs and basic listing data is enough.

How much does it cost?

The cost depends on your Apify plan, run settings, number of results, detail extraction, media extraction, and proxy usage. Start with a small maxResults value to estimate cost for your workflow.

Start scraping Idealista data

Run the Actor with an Idealista search URL or a city-based search, choose your result limit, and export clean property data in minutes.

---

Italiano

Estrai annunci immobiliari da Idealista con filtri, dettagli, immagini e paginazione

Estrai annunci immobiliari da Idealista in Spagna, Italia, Portogallo e Francia. Questo Actor è utile per ricercatori, investitori, agenzie, analisti e team che vogliono dati strutturati senza copiare manualmente ogni annuncio.

Puoi raccogliere prezzi, località, dettagli, immagini, descrizioni e URL da pagine di ricerca o da singole pagine di immobili.

Perché usare questo Actor?

Non vuoi controllare gli annunci a mano, copiare prezzi nei fogli di calcolo o perdere i cambiamenti del mercato?

Questo Actor trasforma le pagine di Idealista in dati JSON ordinati. Puoi esportare, analizzare o collegare questi dati ai tuoi flussi di lavoro.

Vantaggi principali

• Estrai molti annunci in una sola esecuzione.
• Inizia da un URL di Idealista e mantieni paese, località, tipo di immobile e filtri già scelti.
• Raccogli dettagli e contenuti multimediali: prezzo, dimensione, locali, bagni, indirizzo, posizione, descrizione, immagini e URL.
• Cerca per città o zona se non hai già un URL.
• Filtra per prezzo, dimensione, locali, bagni, foto, planimetria, ascensore, garage, riscaldamento, aria condizionata e altro.
• Esporta facilmente in JSON, CSV, Excel, Google Sheets, database o API.
• Pianifica esecuzioni regolari per controllare nuovi annunci, variazioni di prezzo e disponibilità.

Quali dati puoi estrarre?

In base all'annuncio e alle opzioni scelte, l'Actor può estrarre:

• ID e codice dell'immobile
• URL dell'annuncio Idealista
• Paese
• Vendita o affitto
• Tipo di immobile
• Prezzo e valuta
• Dimensione
• Numero di locali e bagni
• Indirizzo, comune/città e provincia/regione
• Latitudine e longitudine, se disponibili
• Descrizione
• Immagine di anteprima
• Altre immagini e contenuti multimediali, se attivati
• Metadati di contatto, se disponibili
• Caratteristiche dell'immobile
• Immobili simili consigliati, se attivati
• URL di origine
• Data e ora di estrazione
• Messaggio di errore per i record non riusciti

Funzioni, vantaggi e risultati

Funzione	Vantaggio	Risultato
Supporto URL di ricerca	Incolla una pagina di ricerca Idealista	Riusa i filtri già scelti
Supporto URL di un immobile	Estrae un singolo annuncio	Ottieni subito dati strutturati
Paginazione automatica	Legge più pagine fino al limite	Non devi cambiare pagina a mano
Ricerca per località	Cerca per paese, operazione, tipo e zona	Crea ricerche senza URL
Filtri di prezzo e dimensione	Limita i risultati	Trova solo immobili adatti
Filtri per locali e bagni	Cerca requisiti precisi	Risparmia tempo
Dettagli facoltativi	Apre le pagine degli annunci	Ottieni record più completi
Contenuti multimediali facoltativi	Raccoglie immagini e media	Crea database e dashboard più ricchi
Immobili consigliati	Include immobili simili	Trova annunci comparabili
Limite configurabile	Controlla quanti record salvare	Gestisci costo, velocità e dimensione

Esempio di output

{
  "id": "35585970",
  "propertyCode": "35585970",
  "url": "https://www.idealista.it/immobile/35585970/",
  "country": "it",
  "operation": "sale",
  "propertyType": "chalet",
  "price": 37000,
  "currency": "EUR",
  "size": 172,
  "rooms": 6,
  "bathrooms": 2,
  "address": "Detached house in Località Scabbiabella, 24, Torriglia",
  "municipality": "Torriglia",
  "province": "Genova",
  "latitude": 44.5184183,
  "longitude": 9.1172171,
  "description": "Scabbiabella – Semi-detached two-level house...",
  "thumbnail": "https://img4.idealista.it/...",
  "multimedia": {
    "images": [
      { "url": "https://img4.idealista.it/...", "tag": "views" },
      { "url": "https://img4.idealista.it/...", "tag": "corridor" }
    ]
  },
  "features": {
    "hasSwimmingPool": false,
    "hasTerrace": true,
    "hasAirConditioning": false,
    "hasBoxRoom": false,
    "hasGarden": false
  },
  "sourceUrl": "https://www.idealista.it/en/vendita-case/genova-provincia/",
  "scrapedAt": "2026-07-11T14:14:42.211Z",
  "status": "success"
}

Come si usa

Opzione 1: estrazione da URL di Idealista

Usa questa opzione se hai già aperto una pagina di ricerca o di un immobile.

1. Apri Idealista.
2. Applica i filtri necessari.
3. Copia l'URL dei risultati o dell'annuncio.
4. Incollalo in Idealista URLs.
5. Imposta Maximum results per query.
6. Avvia l'Actor.

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 100,
  "includeDetails": true,
  "includeMultimedia": true
}

Opzione 2: ricerca per località

Usa questa opzione se non hai un URL e vuoi cercare per paese e zona.

{
  "country": "it",
  "operation": "sale",
  "propertyType": "homes",
  "locationQuery": "Genova",
  "maxResults": 100,
  "minPrice": 100000,
  "maxPrice": 400000,
  "minRooms": 2,
  "includeDetails": true
}

Opzioni di input

Origine della ricerca

Input	Descrizione	Esempio
startUrls	URL di risultati o di singoli immobili. È la scelta migliore se hai già applicato i filtri.	https://www.idealista.it/vendita-case/genova-provincia/
country	Paese per la ricerca per località. Usato quando startUrls è vuoto.	it
operation	Vendita o affitto.	sale
propertyType	Tipo di immobile.	homes
locationQuery	Città, paese, quartiere o zona.	Genova
locationIds	Opzione avanzata per gli ID località di Idealista.	["0-EU-IT-08-000-000001"]
locationSelectionMode	Seleziona la corrispondenza migliore, tutte o solo quella esatta.	best

Paesi supportati: es Spagna, it Italia, pt Portogallo, fr Francia.

Tipi supportati: homes, offices, premises, garages, lands, buildings, rooms, newDevelopments.

Impostazioni dei risultati

Input	Descrizione	Predefinito
maxResults	Numero massimo di immobili per ogni URL o ricerca.	100
includeDetails	Raccoglie più dati dalla pagina dell'immobile. È più lento.	false
includeMultimedia	Raccoglie altre foto e media, se disponibili.	false
includeRecommendations	Raccoglie immobili simili, se disponibili.	false

Filtri per prezzo e dimensione

Questi filtri servono soprattutto per le ricerche per località. Con un URL, i filtri di solito vengono letti dall'URL.

Input	Descrizione
minPrice / maxPrice	Prezzo minimo / massimo
minSize / maxSize	Dimensione minima / massima in metri quadrati
minRooms / maxRooms	Numero minimo / massimo di locali
minBathrooms	Numero minimo di bagni

Filtri dell'immobile

Input	Descrizione
hasPhotos	Preferisce annunci con foto, se supportato
hasPlan	Solo annunci con planimetria, se supportato
exterior	Solo immobili con affaccio esterno, se supportato
elevator	Solo immobili con ascensore, se supportato
airConditioning	Solo immobili con aria condizionata, se supportato
garage	Solo immobili con garage o parcheggio, se supportato
heating	Solo immobili con riscaldamento, se supportato
accessible	Solo immobili accessibili, se supportato
security	Solo immobili con sistemi di sicurezza, se supportato

Impostazioni avanzate

La maggior parte degli utenti può mantenere i valori predefiniti.

Input	Descrizione	Predefinito
quality	Preferenza per qualità di immagini e dettagli.	low
gallery	Include immagini della galleria nei risultati, se disponibili.	true
order	Modalità di ordinamento.	weigh
sort	Direzione di ordinamento.	desc
itemsPerPage	Risultati richiesti per pagina.	50
searchConcurrency	Pagine richieste in parallelo.	4
maxRetries	Tentativi per errori temporanei.	3
requestTimeoutSeconds	Tempo massimo di attesa prima di riprovare.	45
delaySeconds	Pausa tra gruppi di richieste.	0
debug	Attiva log più dettagliati.	false

Casi d'uso comuni

• Ricerca di mercato: confronta prezzi tra città, quartieri e tipi di immobili.
• Controllo dei prezzi: monitora annunci adatti al tuo budget.
• Generazione di lead: raccoglie dati strutturati per attività immobiliari.
• Analisi di investimento: analizza prezzo, dimensione, posizione e caratteristiche.
• Analisi della concorrenza: controlla l'offerta nelle zone scelte.
• Controllo dell'inventario: crea dataset per dashboard interne.
• Analisi delle località: mostra gli immobili su una mappa con le coordinate.

Perché scegliere questo Actor

• Ricerca flessibile tramite URL o località.
• Output ordinato con campi normalizzati.
• Filtri utili per prezzo, dimensione, locali e caratteristiche.
• Dettagli e media facoltativi.
• Supporto per Spagna, Italia, Portogallo e Francia.
• Esportazione verso dataset, API, fogli di calcolo e altri sistemi.
• Pianificazione giornaliera, settimanale o oraria.

Automatizza il monitoraggio con esecuzioni pianificate

Puoi fare eseguire l'Actor ogni giorno, ogni settimana o con la frequenza necessaria.

Idee

• Controllo giornaliero dei nuovi annunci
• Controllo delle variazioni di prezzo
• Liste di immobili per investitori
• Controllo dell'offerta per agenzie
• Report di mercato settimanali
• Invio di nuovi annunci a CRM o database

Come pianificare l'Actor su Apify

1. Apri l'Actor su Apify.
2. Fai clic su Run e configura l'input.
3. Salva il task dopo una prova riuscita.
4. Apri Schedules.
5. Crea una pianificazione e seleziona il task.
6. Scegli la frequenza.
7. Collega il dataset a Google Sheets, API, Make, Zapier o al tuo database.

Esempio:

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 200,
  "includeDetails": true,
  "includeMultimedia": false
}

Esegui questo task ogni mattina per creare un dataset degli immobili in vendita a Genova. Confronta i dataset per trovare nuovi annunci, annunci rimossi e variazioni di prezzo.

Domande frequenti

Questo Actor richiede proxy?

I proxy sono consigliati per un'estrazione affidabile. La configurazione predefinita è adatta alla maggior parte delle esecuzioni su Apify.

Può estrarre tutte le pagine di una ricerca?

Sì, fino al valore maxResults. Ricerche molto grandi possono dipendere dalla disponibilità, dal comportamento del sito e dai filtri.

Posso estrarre un singolo immobile?

Sì. Inserisci l'URL in startUrls e avvia l'Actor.

Posso usare i filtri di Idealista?

Sì. Applica i filtri su Idealista e copia l'URL risultante in startUrls.

Supporta più paesi?

Sì: Spagna (es), Italia (it), Portogallo (pt) e Francia (fr).

Supporta affitti e vendite?

Sì. Per una ricerca per località, imposta operation su sale o rent. Per una ricerca tramite URL, usa l'URL corretto.

Perché alcuni campi sono vuoti?

Alcuni annunci non hanno tutti i dati. Coordinate, bagni, caratteristiche, immagini o dati di contatto possono mancare.

Devo attivare includeDetails?

Attivalo se vuoi record più completi. Lascialo disattivato se vuoi maggiore velocità e ti bastano i dati di base.

Quanto costa?

Il costo dipende dal piano Apify, dalle impostazioni, dal numero di risultati, dai dettagli, dai media e dai proxy. Inizia con un valore maxResults basso per fare una stima.

Inizia a estrarre dati da Idealista

Avvia l'Actor con un URL di Idealista o una ricerca per città, scegli il limite ed esporta dati immobiliari ordinati in pochi minuti.

---

Español

Extrae anuncios de Idealista con filtros, detalles, imágenes y paginación

Extrae anuncios inmobiliarios de Idealista en España, Italia, Portugal y Francia. Este Actor sirve para investigadores, inversores, agencias, analistas y equipos que necesitan datos estructurados sin copiar cada anuncio a mano.

Puedes recopilar precios, ubicaciones, detalles, imágenes, descripciones y URL desde páginas de búsqueda o páginas de inmuebles.

¿Por qué usar este Actor?

¿No quieres revisar anuncios a mano, copiar precios en hojas de cálculo o perder cambios del mercado?

Este Actor convierte las páginas de Idealista en datos JSON limpios. Puedes exportarlos, analizarlos o conectarlos a tus procesos.

Ventajas principales

• Extrae muchos anuncios en una ejecución.
• Empieza con una URL de Idealista y conserva el país, la ubicación, el tipo de inmueble y los filtros elegidos.
• Recopila detalles y contenido multimedia: precio, tamaño, habitaciones, baños, dirección, ubicación, descripción, imágenes y URL.
• Busca por ciudad o zona si no tienes una URL.
• Filtra por precio, tamaño, habitaciones, baños, fotos, plano, ascensor, garaje, calefacción, aire acondicionado y más.
• Exporta fácilmente a JSON, CSV, Excel, Google Sheets, bases de datos o API.
• Programa ejecuciones periódicas para controlar anuncios nuevos, cambios de precio e inventario.

¿Qué datos puedes extraer?

Según el anuncio y las opciones elegidas, el Actor puede extraer:

• ID y código del inmueble
• URL del anuncio de Idealista
• País
• Venta o alquiler
• Tipo de inmueble
• Precio y moneda
• Tamaño
• Número de habitaciones y baños
• Dirección, municipio/ciudad y provincia/región
• Latitud y longitud, si están disponibles
• Descripción
• Imagen en miniatura
• Más imágenes y contenido multimedia, si se activa
• Metadatos de contacto, si están disponibles
• Características del inmueble
• Inmuebles similares recomendados, si se activa
• URL de origen
• Fecha y hora de extracción
• Mensaje de error para registros fallidos

Funciones, ventajas y beneficios

Función	Ventaja	Beneficio
URL de búsqueda	Pega una página de búsqueda	Reutiliza los filtros elegidos
URL de un inmueble	Extrae un solo anuncio	Obtén datos estructurados rápidamente
Paginación automática	Lee varias páginas hasta el límite	No cambies de página a mano
Búsqueda por ubicación	Busca por país, operación, tipo y zona	Crea búsquedas sin URL
Filtros de precio y tamaño	Limita los resultados	Encuentra inmuebles adecuados
Filtros de habitaciones y baños	Busca requisitos concretos	Ahorra tiempo
Detalles opcionales	Abre las páginas de anuncios	Obtén registros más completos
Multimedia opcional	Recopila imágenes y otros medios	Crea bases de datos más completas
Inmuebles recomendados	Incluye inmuebles similares	Encuentra anuncios comparables
Límite configurable	Controla cuántos registros se guardan	Gestiona coste, velocidad y tamaño

Ejemplo de salida

{
  "id": "35585970",
  "propertyCode": "35585970",
  "url": "https://www.idealista.it/immobile/35585970/",
  "country": "it",
  "operation": "sale",
  "propertyType": "chalet",
  "price": 37000,
  "currency": "EUR",
  "size": 172,
  "rooms": 6,
  "bathrooms": 2,
  "address": "Detached house in Località Scabbiabella, 24, Torriglia",
  "municipality": "Torriglia",
  "province": "Genova",
  "latitude": 44.5184183,
  "longitude": 9.1172171,
  "description": "Scabbiabella – Semi-detached two-level house...",
  "thumbnail": "https://img4.idealista.it/...",
  "multimedia": {
    "images": [
      { "url": "https://img4.idealista.it/...", "tag": "views" },
      { "url": "https://img4.idealista.it/...", "tag": "corridor" }
    ]
  },
  "features": {
    "hasSwimmingPool": false,
    "hasTerrace": true,
    "hasAirConditioning": false,
    "hasBoxRoom": false,
    "hasGarden": false
  },
  "sourceUrl": "https://www.idealista.it/en/vendita-case/genova-provincia/",
  "scrapedAt": "2026-07-11T14:14:42.211Z",
  "status": "success"
}

Cómo usarlo

Opción 1: extraer desde URL de Idealista

Usa esta opción si ya tienes abierta una búsqueda o la página de un inmueble.

1. Abre Idealista.
2. Aplica los filtros necesarios.
3. Copia la URL de resultados o del anuncio.
4. Pégala en Idealista URLs.
5. Define Maximum results per query.
6. Ejecuta el Actor.

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 100,
  "includeDetails": true,
  "includeMultimedia": true
}

Opción 2: buscar por ubicación

Usa esta opción si no tienes una URL y quieres buscar por país y zona.

{
  "country": "it",
  "operation": "sale",
  "propertyType": "homes",
  "locationQuery": "Genova",
  "maxResults": 100,
  "minPrice": 100000,
  "maxPrice": 400000,
  "minRooms": 2,
  "includeDetails": true
}

Opciones de entrada

Origen de la búsqueda

Entrada	Descripción	Ejemplo
startUrls	URL de resultados o de inmuebles. Es la mejor opción si ya aplicaste filtros.	https://www.idealista.it/vendita-case/genova-provincia/
country	País para búsquedas por ubicación. Se usa si startUrls está vacío.	it
operation	Venta o alquiler.	sale
propertyType	Tipo de inmueble.	homes
locationQuery	Ciudad, población, barrio o zona.	Genova
locationIds	Opción avanzada para ID de ubicación de Idealista.	["0-EU-IT-08-000-000001"]
locationSelectionMode	Elige la mejor coincidencia, todas o solo la exacta.	best

Países admitidos: es España, it Italia, pt Portugal, fr Francia.

Tipos admitidos: homes, offices, premises, garages, lands, buildings, rooms, newDevelopments.

Ajustes de resultados

Entrada	Descripción	Predeterminado
maxResults	Máximo de inmuebles por URL o búsqueda.	100
includeDetails	Recopila más datos de cada inmueble. Es más lento.	false
includeMultimedia	Recopila más fotos y contenido multimedia.	false
includeRecommendations	Recopila inmuebles similares.	false

Filtros de precio y tamaño

Se usan sobre todo en búsquedas por ubicación. Con una URL, los filtros normalmente se leen desde la URL.

Entrada	Descripción
minPrice / maxPrice	Precio mínimo / máximo
minSize / maxSize	Tamaño mínimo / máximo en metros cuadrados
minRooms / maxRooms	Número mínimo / máximo de habitaciones
minBathrooms	Número mínimo de baños

Filtros del inmueble

Entrada	Descripción
hasPhotos	Prefiere anuncios con fotos, si se admite
hasPlan	Solo anuncios con plano, si se admite
exterior	Solo inmuebles exteriores, si se admite
elevator	Solo inmuebles con ascensor, si se admite
airConditioning	Solo inmuebles con aire acondicionado, si se admite
garage	Solo inmuebles con garaje o aparcamiento, si se admite
heating	Solo inmuebles con calefacción, si se admite
accessible	Solo inmuebles accesibles, si se admite
security	Solo inmuebles con medidas de seguridad, si se admite

Ajustes avanzados

La mayoría de los usuarios puede mantener los valores predeterminados.

Entrada	Descripción	Predeterminado
quality	Preferencia de calidad de imágenes y detalles.	low
gallery	Incluye imágenes de galería, si están disponibles.	true
order	Modo de ordenación.	weigh
sort	Dirección de ordenación.	desc
itemsPerPage	Resultados solicitados por página.	50
searchConcurrency	Páginas solicitadas en paralelo.	4
maxRetries	Reintentos para errores temporales.	3
requestTimeoutSeconds	Tiempo máximo de espera antes de reintentar.	45
delaySeconds	Pausa entre grupos de solicitudes.	0
debug	Activa registros más detallados.	false

Casos de uso comunes

• Estudio de mercado: compara precios entre ciudades, barrios y tipos.
• Control de precios: vigila anuncios que cumplen tu presupuesto.
• Generación de contactos: recopila datos para procesos inmobiliarios.
• Análisis de inversión: analiza precio, tamaño, ubicación y características.
• Análisis de competencia: controla la oferta en zonas objetivo.
• Control de inventario: crea conjuntos de datos para paneles internos.
• Análisis de ubicación: muestra inmuebles en mapas con sus coordenadas.

Por qué elegir este Actor

• Búsqueda flexible mediante URL o ubicación.
• Salida limpia con campos normalizados.
• Filtros de precio, tamaño, habitaciones y características.
• Detalles y contenido multimedia opcionales.
• Compatible con España, Italia, Portugal y Francia.
• Exportación a conjuntos de datos, API, hojas de cálculo y otros sistemas.
• Programación diaria, semanal o cada hora.

Automatiza el control con ejecuciones programadas

Puedes ejecutar el Actor cada día, cada semana o con la frecuencia que necesites.

Ideas

• Control diario de anuncios nuevos
• Control de cambios de precio
• Listas de seguimiento para inversores
• Control de inventario para agencias
• Informes semanales del mercado
• Envío de anuncios nuevos a un CRM o una base de datos

Cómo programar el Actor en Apify

1. Abre el Actor en Apify.
2. Haz clic en Run y configura la entrada.
3. Guarda la tarea después de una prueba correcta.
4. Abre Schedules.
5. Crea una programación y elige la tarea.
6. Elige la frecuencia.
7. Conecta el conjunto de datos a Google Sheets, una API, Make, Zapier o tu base de datos.

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 200,
  "includeDetails": true,
  "includeMultimedia": false
}

Ejecuta esta tarea cada mañana para crear un conjunto de datos de inmuebles en venta en Génova. Compara los datos para detectar anuncios nuevos, eliminados y cambios de precio.

Preguntas frecuentes

¿Este Actor necesita proxies?

Se recomiendan proxies para una extracción fiable. La configuración predeterminada sirve para la mayoría de las ejecuciones en Apify.

¿Puede extraer todas las páginas de una búsqueda?

Sí, hasta el valor de maxResults. Las búsquedas muy grandes dependen de la disponibilidad, el comportamiento del sitio y los filtros.

¿Puedo extraer un solo inmueble?

Sí. Añade su URL a startUrls y ejecuta el Actor.

¿Puedo usar los filtros de Idealista?

Sí. Aplica los filtros en Idealista y copia la URL resultante en startUrls.

¿Admite varios países?

Sí: España (es), Italia (it), Portugal (pt) y Francia (fr).

¿Admite alquiler y venta?

Sí. Para búsquedas por ubicación, define operation como sale o rent. Para búsquedas por URL, usa la URL correspondiente.

¿Por qué hay campos vacíos?

Algunos anuncios no incluyen todos los datos. Pueden faltar coordenadas, baños, características, imágenes o datos de contacto.

¿Debo activar includeDetails?

Actívalo si necesitas registros más completos. Déjalo desactivado si prefieres más velocidad y los datos básicos son suficientes.

¿Cuánto cuesta?

El coste depende del plan de Apify, los ajustes, el número de resultados, los detalles, el contenido multimedia y los proxies. Empieza con un valor bajo de maxResults para calcular el coste.

Empieza a extraer datos de Idealista

Ejecuta el Actor con una URL de Idealista o una búsqueda por ciudad, elige el límite y exporta datos inmobiliarios limpios en pocos minutos.

---

Português

Extraia anúncios do Idealista com filtros, detalhes, imagens e paginação

Extraia anúncios de imóveis do Idealista em Espanha, Itália, Portugal e França. Este Actor é útil para investigadores, investidores, agências, analistas e equipas que precisam de dados estruturados sem copiar cada anúncio manualmente.

Pode recolher preços, localizações, detalhes, imagens, descrições e URLs de páginas de pesquisa ou de páginas de imóveis.

Porquê usar este Actor?

Não quer verificar anúncios manualmente, copiar preços para folhas de cálculo ou perder alterações no mercado?

Este Actor transforma páginas do Idealista em dados JSON organizados. Pode exportar, analisar ou ligar estes dados aos seus processos.

Principais vantagens

• Extraia muitos anúncios numa execução.
• Comece com um URL do Idealista e mantenha o país, a localização, o tipo de imóvel e os filtros escolhidos.
• Recolha detalhes e multimédia: preço, área, quartos, casas de banho, morada, localização, descrição, imagens e URL.
• Pesquise por cidade ou zona se não tiver um URL.
• Filtre por preço, área, quartos, casas de banho, fotografias, planta, elevador, garagem, aquecimento, ar condicionado e mais.
• Exporte facilmente para JSON, CSV, Excel, Google Sheets, bases de dados ou APIs.
• Agende execuções regulares para acompanhar novos anúncios, alterações de preço e oferta.

Que dados pode extrair?

Conforme o anúncio e as opções escolhidas, o Actor pode extrair:

• ID e código do imóvel
• URL do anúncio no Idealista
• País
• Venda ou arrendamento
• Tipo de imóvel
• Preço e moeda
• Área
• Número de quartos e casas de banho
• Morada, município/cidade e distrito/região
• Latitude e longitude, quando disponíveis
• Descrição
• Imagem em miniatura
• Mais imagens e conteúdos multimédia, quando ativados
• Metadados de contacto, quando disponíveis
• Características do imóvel
• Imóveis semelhantes recomendados, quando ativados
• URL de origem
• Data e hora da extração
• Mensagem de erro para registos com falha

Funcionalidades, vantagens e benefícios

Funcionalidade	Vantagem	Benefício
URL de pesquisa	Cole uma página de pesquisa	Reutilize os filtros escolhidos
URL de um imóvel	Extraia um anúncio	Obtenha dados estruturados rapidamente
Paginação automática	Lê várias páginas até ao limite	Não mude de página manualmente
Pesquisa por localização	Pesquise por país, operação, tipo e zona	Crie pesquisas sem URL
Filtros de preço e área	Limite os resultados	Encontre imóveis adequados
Filtros de quartos e casas de banho	Defina requisitos específicos	Poupe tempo
Detalhes opcionais	Abre as páginas dos anúncios	Obtenha registos mais completos
Multimédia opcional	Recolhe imagens e outros conteúdos	Crie bases de dados mais completas
Imóveis recomendados	Inclui imóveis semelhantes	Encontre anúncios comparáveis
Limite configurável	Controla quantos registos são guardados	Controle custo, velocidade e tamanho

Exemplo de resultado

{
  "id": "35585970",
  "propertyCode": "35585970",
  "url": "https://www.idealista.it/immobile/35585970/",
  "country": "it",
  "operation": "sale",
  "propertyType": "chalet",
  "price": 37000,
  "currency": "EUR",
  "size": 172,
  "rooms": 6,
  "bathrooms": 2,
  "address": "Detached house in Località Scabbiabella, 24, Torriglia",
  "municipality": "Torriglia",
  "province": "Genova",
  "latitude": 44.5184183,
  "longitude": 9.1172171,
  "description": "Scabbiabella – Semi-detached two-level house...",
  "thumbnail": "https://img4.idealista.it/...",
  "multimedia": {
    "images": [
      { "url": "https://img4.idealista.it/...", "tag": "views" },
      { "url": "https://img4.idealista.it/...", "tag": "corridor" }
    ]
  },
  "features": {
    "hasSwimmingPool": false,
    "hasTerrace": true,
    "hasAirConditioning": false,
    "hasBoxRoom": false,
    "hasGarden": false
  },
  "sourceUrl": "https://www.idealista.it/en/vendita-case/genova-provincia/",
  "scrapedAt": "2026-07-11T14:14:42.211Z",
  "status": "success"
}

Como usar

Opção 1: extrair a partir de URLs do Idealista

Use esta opção se já tiver uma página de pesquisa ou de um imóvel aberta.

1. Abra o Idealista.
2. Aplique os filtros necessários.
3. Copie o URL dos resultados ou do anúncio.
4. Cole-o em Idealista URLs.
5. Defina Maximum results per query.
6. Execute o Actor.

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 100,
  "includeDetails": true,
  "includeMultimedia": true
}

Opção 2: pesquisar por localização

Use esta opção se não tiver um URL e quiser pesquisar por país e zona.

{
  "country": "it",
  "operation": "sale",
  "propertyType": "homes",
  "locationQuery": "Genova",
  "maxResults": 100,
  "minPrice": 100000,
  "maxPrice": 400000,
  "minRooms": 2,
  "includeDetails": true
}

Opções de entrada

Origem da pesquisa

Entrada	Descrição	Exemplo
startUrls	URLs de resultados ou de imóveis. É a melhor opção se já aplicou filtros.	https://www.idealista.it/vendita-case/genova-provincia/
country	País para pesquisas por localização. Usado quando startUrls está vazio.	it
operation	Venda ou arrendamento.	sale
propertyType	Tipo de imóvel.	homes
locationQuery	Cidade, vila, bairro ou zona.	Genova
locationIds	Opção avançada para IDs de localização do Idealista.	["0-EU-IT-08-000-000001"]
locationSelectionMode	Escolha a melhor correspondência, todas ou apenas a exata.	best

Países suportados: es Espanha, it Itália, pt Portugal, fr França.

Tipos suportados: homes, offices, premises, garages, lands, buildings, rooms, newDevelopments.

Definições dos resultados

Entrada	Descrição	Predefinição
maxResults	Máximo de imóveis por URL ou pesquisa.	100
includeDetails	Recolhe mais dados de cada imóvel. É mais lento.	false
includeMultimedia	Recolhe mais fotografias e multimédia.	false
includeRecommendations	Recolhe imóveis semelhantes.	false

Filtros de preço e área

São usados principalmente em pesquisas por localização. Com um URL, os filtros são normalmente lidos a partir do URL.

Entrada	Descrição
minPrice / maxPrice	Preço mínimo / máximo
minSize / maxSize	Área mínima / máxima em metros quadrados
minRooms / maxRooms	Número mínimo / máximo de quartos
minBathrooms	Número mínimo de casas de banho

Filtros do imóvel

Entrada	Descrição
hasPhotos	Prefere anúncios com fotografias, quando suportado
hasPlan	Apenas anúncios com planta, quando suportado
exterior	Apenas imóveis exteriores, quando suportado
elevator	Apenas imóveis com elevador, quando suportado
airConditioning	Apenas imóveis com ar condicionado, quando suportado
garage	Apenas imóveis com garagem ou estacionamento, quando suportado
heating	Apenas imóveis com aquecimento, quando suportado
accessible	Apenas imóveis acessíveis, quando suportado
security	Apenas imóveis com elementos de segurança, quando suportado

Definições avançadas

A maioria dos utilizadores pode manter os valores predefinidos.

Entrada	Descrição	Predefinição
quality	Preferência de qualidade para imagens e detalhes.	low
gallery	Inclui imagens da galeria, quando disponíveis.	true
order	Modo de ordenação.	weigh
sort	Direção da ordenação.	desc
itemsPerPage	Resultados pedidos por página.	50
searchConcurrency	Páginas pedidas em paralelo.	4
maxRetries	Novas tentativas para erros temporários.	3
requestTimeoutSeconds	Tempo máximo de espera antes de tentar novamente.	45
delaySeconds	Pausa entre grupos de pedidos.	0
debug	Ativa registos mais detalhados.	false

Casos de uso comuns

• Estudo de mercado: compare preços entre cidades, bairros e tipos.
• Acompanhamento de preços: siga anúncios dentro do seu orçamento.
• Geração de contactos: recolha dados para processos imobiliários.
• Análise de investimento: analise preço, área, localização e características.
• Análise da concorrência: acompanhe a oferta nas zonas escolhidas.
• Controlo de inventário: crie conjuntos de dados para painéis internos.
• Análise de localização: mostre imóveis em mapas com coordenadas.

Porquê escolher este Actor

• Pesquisa flexível por URL ou localização.
• Resultado limpo com campos normalizados.
• Filtros de preço, área, quartos e características.
• Detalhes e multimédia opcionais.
• Suporte para Espanha, Itália, Portugal e França.
• Exportação para conjuntos de dados, APIs, folhas de cálculo e outros sistemas.
• Agendamento diário, semanal ou horário.

Automatize o acompanhamento com execuções agendadas

Pode executar o Actor todos os dias, todas as semanas ou com a frequência necessária.

Ideias

• Acompanhamento diário de novos anúncios
• Acompanhamento de alterações de preço
• Listas para investidores
• Controlo da oferta para agências
• Relatórios semanais de mercado
• Envio de novos anúncios para um CRM ou uma base de dados

Como agendar o Actor no Apify

1. Abra o Actor no Apify.
2. Clique em Run e configure a entrada.
3. Guarde a tarefa depois de um teste correto.
4. Abra Schedules.
5. Crie um agendamento e escolha a tarefa.
6. Escolha a frequência.
7. Ligue o conjunto de dados ao Google Sheets, a uma API, ao Make, ao Zapier ou à sua base de dados.

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 200,
  "includeDetails": true,
  "includeMultimedia": false
}

Execute esta tarefa todas as manhãs para criar um conjunto de dados de imóveis à venda em Génova. Compare os dados para encontrar anúncios novos, removidos e alterações de preço.

Perguntas frequentes

Este Actor precisa de proxies?

Os proxies são recomendados para uma extração fiável. A configuração predefinida serve para a maioria das execuções no Apify.

Pode extrair todas as páginas de uma pesquisa?

Sim, até ao valor de maxResults. Pesquisas muito grandes dependem da disponibilidade, do comportamento do site e dos filtros.

Posso extrair um único imóvel?

Sim. Adicione o URL a startUrls e execute o Actor.

Posso usar os filtros do Idealista?

Sim. Aplique os filtros no Idealista e copie o URL resultante para startUrls.

Suporta vários países?

Sim: Espanha (es), Itália (it), Portugal (pt) e França (fr).

Suporta arrendamento e venda?

Sim. Para pesquisas por localização, defina operation como sale ou rent. Para pesquisas por URL, use o URL correspondente.

Porque estão alguns campos vazios?

Alguns anúncios não incluem todos os dados. Podem faltar coordenadas, casas de banho, características, imagens ou dados de contacto.

Devo ativar includeDetails?

Ative se precisar de registos mais completos. Deixe desativado se quiser mais velocidade e os dados básicos forem suficientes.

Quanto custa?

O custo depende do plano Apify, das definições, do número de resultados, dos detalhes, da multimédia e dos proxies. Comece com um valor baixo de maxResults para estimar o custo.

Comece a extrair dados do Idealista

Execute o Actor com um URL do Idealista ou uma pesquisa por cidade, escolha o limite e exporte dados de imóveis organizados em poucos minutos.

---

Français

Extrayez les annonces Idealista avec filtres, détails, images et pagination

Extrayez des annonces immobilières Idealista en Espagne, en Italie, au Portugal et en France. Cet Actor est utile aux chercheurs, investisseurs, agences, analystes et équipes qui ont besoin de données structurées sans copier chaque annonce à la main.

Vous pouvez collecter les prix, lieux, détails, images, descriptions et URL depuis les pages de recherche ou les pages de biens.

Pourquoi utiliser cet Actor ?

Vous ne voulez plus vérifier les annonces à la main, copier les prix dans des feuilles de calcul ou manquer les changements du marché ?

Cet Actor transforme les pages Idealista en données JSON propres. Vous pouvez les exporter, les analyser ou les connecter à vos processus.

Principaux avantages

• Extrayez de nombreuses annonces en une exécution.
• Commencez avec une URL Idealista et conservez le pays, le lieu, le type de bien et les filtres choisis.
• Collectez les détails et les médias : prix, surface, pièces, salles de bains, adresse, lieu, description, images et URL.
• Recherchez par ville ou zone si vous n'avez pas d'URL.
• Filtrez par prix, surface, pièces, salles de bains, photos, plan, ascenseur, garage, chauffage, climatisation et plus.
• Exportez facilement vers JSON, CSV, Excel, Google Sheets, des bases de données ou des API.
• Planifiez des exécutions régulières pour suivre les nouvelles annonces, les changements de prix et l'offre.

Quelles données pouvez-vous extraire ?

Selon l'annonce et les options choisies, l'Actor peut extraire :

• Identifiant et code du bien
• URL de l'annonce Idealista
• Pays
• Vente ou location
• Type de bien
• Prix et devise
• Surface
• Nombre de pièces et de salles de bains
• Adresse, commune/ville et département/région
• Latitude et longitude, si disponibles
• Description
• Image miniature
• Autres images et médias, si activés
• Métadonnées de contact, si disponibles
• Caractéristiques du bien
• Biens similaires recommandés, si activés
• URL source
• Date et heure de l'extraction
• Message d'erreur pour les enregistrements en échec

Fonctions, avantages et bénéfices

Fonction	Avantage	Bénéfice
URL de recherche	Collez une page de recherche	Réutilisez les filtres choisis
URL d'un bien	Extrayez une seule annonce	Obtenez vite des données structurées
Pagination automatique	Lit plusieurs pages jusqu'à la limite	Ne changez pas de page à la main
Recherche par lieu	Recherchez par pays, opération, type et zone	Créez une recherche sans URL
Filtres de prix et de surface	Limitez les résultats	Trouvez les biens adaptés
Filtres de pièces et salles de bains	Définissez des critères précis	Gagnez du temps
Détails facultatifs	Ouvre les pages des annonces	Obtenez des données plus complètes
Médias facultatifs	Collecte les images et autres médias	Créez des bases plus riches
Biens recommandés	Inclut des biens similaires	Trouvez des annonces comparables
Limite configurable	Contrôle le nombre de données enregistrées	Gérez le coût, la vitesse et la taille

Exemple de résultat

{
  "id": "35585970",
  "propertyCode": "35585970",
  "url": "https://www.idealista.it/immobile/35585970/",
  "country": "it",
  "operation": "sale",
  "propertyType": "chalet",
  "price": 37000,
  "currency": "EUR",
  "size": 172,
  "rooms": 6,
  "bathrooms": 2,
  "address": "Detached house in Località Scabbiabella, 24, Torriglia",
  "municipality": "Torriglia",
  "province": "Genova",
  "latitude": 44.5184183,
  "longitude": 9.1172171,
  "description": "Scabbiabella – Semi-detached two-level house...",
  "thumbnail": "https://img4.idealista.it/...",
  "multimedia": {
    "images": [
      { "url": "https://img4.idealista.it/...", "tag": "views" },
      { "url": "https://img4.idealista.it/...", "tag": "corridor" }
    ]
  },
  "features": {
    "hasSwimmingPool": false,
    "hasTerrace": true,
    "hasAirConditioning": false,
    "hasBoxRoom": false,
    "hasGarden": false
  },
  "sourceUrl": "https://www.idealista.it/en/vendita-case/genova-provincia/",
  "scrapedAt": "2026-07-11T14:14:42.211Z",
  "status": "success"
}

Comment l'utiliser

Option 1 : extraction depuis des URL Idealista

Utilisez cette option si une page de recherche ou de bien est déjà ouverte.

1. Ouvrez Idealista.
2. Appliquez les filtres nécessaires.
3. Copiez l'URL des résultats ou de l'annonce.
4. Collez-la dans Idealista URLs.
5. Définissez Maximum results per query.
6. Exécutez l'Actor.

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 100,
  "includeDetails": true,
  "includeMultimedia": true
}

Option 2 : recherche par lieu

Utilisez cette option si vous n'avez pas d'URL et souhaitez rechercher par pays et zone.

{
  "country": "it",
  "operation": "sale",
  "propertyType": "homes",
  "locationQuery": "Genova",
  "maxResults": 100,
  "minPrice": 100000,
  "maxPrice": 400000,
  "minRooms": 2,
  "includeDetails": true
}

Options d'entrée

Source de la recherche

Entrée	Description	Exemple
startUrls	URL de résultats ou de biens. C'est le meilleur choix si vous avez déjà appliqué des filtres.	https://www.idealista.it/vendita-case/genova-provincia/
country	Pays pour les recherches par lieu. Utilisé si startUrls est vide.	it
operation	Vente ou location.	sale
propertyType	Type de bien.	homes
locationQuery	Ville, commune, quartier ou zone.	Genova
locationIds	Option avancée pour les identifiants de lieu Idealista.	["0-EU-IT-08-000-000001"]
locationSelectionMode	Choisit le meilleur résultat, tous les résultats ou le résultat exact.	best

Pays pris en charge : es Espagne, it Italie, pt Portugal, fr France.

Types pris en charge : homes, offices, premises, garages, lands, buildings, rooms, newDevelopments.

Réglages des résultats

Entrée	Description	Valeur par défaut
maxResults	Nombre maximal de biens par URL ou recherche.	100
includeDetails	Collecte plus de données sur chaque bien. Plus lent.	false
includeMultimedia	Collecte plus de photos et de médias.	false
includeRecommendations	Collecte des biens similaires.	false

Filtres de prix et de surface

Ils servent surtout aux recherches par lieu. Avec une URL, les filtres sont généralement lus dans l'URL.

Entrée	Description
minPrice / maxPrice	Prix minimal / maximal
minSize / maxSize	Surface minimale / maximale en mètres carrés
minRooms / maxRooms	Nombre minimal / maximal de pièces
minBathrooms	Nombre minimal de salles de bains

Filtres du bien

Entrée	Description
hasPhotos	Préfère les annonces avec photos, si disponible
hasPlan	Uniquement les annonces avec un plan, si disponible
exterior	Uniquement les biens donnant sur l'extérieur, si disponible
elevator	Uniquement les biens avec ascenseur, si disponible
airConditioning	Uniquement les biens avec climatisation, si disponible
garage	Uniquement les biens avec garage ou parking, si disponible
heating	Uniquement les biens avec chauffage, si disponible
accessible	Uniquement les biens accessibles, si disponible
security	Uniquement les biens avec équipements de sécurité, si disponible

Réglages avancés

La plupart des utilisateurs peuvent conserver les valeurs par défaut.

Entrée	Description	Valeur par défaut
quality	Préférence de qualité des images et détails.	low
gallery	Inclut les images de galerie, si disponibles.	true
order	Mode de classement.	weigh
sort	Sens du tri.	desc
itemsPerPage	Résultats demandés par page.	50
searchConcurrency	Pages demandées en parallèle.	4
maxRetries	Nouvelles tentatives après une erreur temporaire.	3
requestTimeoutSeconds	Temps d'attente maximal avant une nouvelle tentative.	45
delaySeconds	Pause entre les groupes de requêtes.	0
debug	Active des journaux plus détaillés.	false

Cas d'utilisation courants

• Étude de marché : comparez les prix entre villes, quartiers et types.
• Suivi des prix : suivez les annonces qui respectent votre budget.
• Génération de prospects : collectez des données pour vos processus immobiliers.
• Analyse d'investissement : analysez le prix, la surface, le lieu et les caractéristiques.
• Analyse concurrentielle : suivez l'offre dans les zones ciblées.
• Suivi de l'inventaire : créez des jeux de données pour vos tableaux de bord.
• Analyse géographique : affichez les biens sur une carte avec leurs coordonnées.

Pourquoi choisir cet Actor

• Recherche flexible par URL ou lieu.
• Résultat propre avec des champs normalisés.
• Filtres de prix, surface, pièces et caractéristiques.
• Détails et médias facultatifs.
• Prise en charge de l'Espagne, de l'Italie, du Portugal et de la France.
• Export vers des jeux de données, API, feuilles de calcul et autres systèmes.
• Planification quotidienne, hebdomadaire ou horaire.

Automatisez le suivi avec des exécutions planifiées

Vous pouvez exécuter l'Actor chaque jour, chaque semaine ou à la fréquence nécessaire.

Idées

• Suivi quotidien des nouvelles annonces
• Suivi des changements de prix
• Listes de suivi pour les investisseurs
• Suivi de l'offre pour les agences
• Rapports de marché hebdomadaires
• Envoi des nouvelles annonces vers un CRM ou une base de données

Comment planifier l'Actor sur Apify

1. Ouvrez l'Actor sur Apify.
2. Cliquez sur Run et configurez l'entrée.
3. Enregistrez la tâche après un test réussi.
4. Ouvrez Schedules.
5. Créez une planification et choisissez la tâche.
6. Choisissez la fréquence.
7. Connectez le jeu de données à Google Sheets, une API, Make, Zapier ou votre base de données.

{
  "startUrls": [{ "url": "https://www.idealista.it/vendita-case/genova-provincia/" }],
  "maxResults": 200,
  "includeDetails": true,
  "includeMultimedia": false
}

Exécutez cette tâche chaque matin pour créer un jeu de données des biens à vendre à Gênes. Comparez les données pour trouver les nouvelles annonces, les annonces supprimées et les changements de prix.

Questions fréquentes

Cet Actor nécessite-t-il des proxies ?

Les proxies sont recommandés pour une extraction fiable. La configuration par défaut convient à la plupart des exécutions sur Apify.

Peut-il extraire toutes les pages d'une recherche ?

Oui, jusqu'à la valeur de maxResults. Les grandes recherches dépendent de la disponibilité, du comportement du site et des filtres.

Puis-je extraire un seul bien ?

Oui. Ajoutez son URL dans startUrls et exécutez l'Actor.

Puis-je utiliser les filtres d'Idealista ?

Oui. Appliquez les filtres sur Idealista et copiez l'URL obtenue dans startUrls.

Prend-il en charge plusieurs pays ?

Oui : Espagne (es), Italie (it), Portugal (pt) et France (fr).

Prend-il en charge la location et la vente ?

Oui. Pour une recherche par lieu, définissez operation sur sale ou rent. Pour une recherche par URL, utilisez l'URL correspondante.

Pourquoi certains champs sont-ils vides ?

Certaines annonces ne donnent pas toutes les données. Les coordonnées, salles de bains, caractéristiques, images ou coordonnées de contact peuvent manquer.

Dois-je activer includeDetails ?

Activez cette option si vous voulez des données plus complètes. Désactivez-la si vous préférez une exécution rapide et si les données de base suffisent.

Combien cela coûte-t-il ?

Le coût dépend de votre forfait Apify, des réglages, du nombre de résultats, des détails, des médias et des proxies. Commencez avec une faible valeur de maxResults pour estimer le coût.

Commencez à extraire les données Idealista

Exécutez l'Actor avec une URL Idealista ou une recherche par ville, choisissez la limite et exportez des données immobilières propres en quelques minutes.