🏠 Idealista Scraper — Properties, Phones & Agency Leads

Turn Idealista searches and property URLs into clean, structured real-estate data from Spain 🇪🇸, Italy 🇮🇹 and Portugal 🇵🇹. Collect advertiser phones, available property details and source-linked public agency contacts in a single workflow.

✨ Pick the package you actually need

Result package	Best for	What it collects
⚡ Fast	Market scans, price analysis, calling lists	Search-card data, prices, location, photos, advertiser and resilient phone enrichment
🏠 Full details	Property databases and valuation	Everything in Fast plus full description, features, coordinates, energy data, floor plans and all photos
📧 Leads	Agency prospecting and CRM enrichment	Everything in Full details plus one public contact lookup per unique professional agency

The Leads package never guesses email addresses. It only returns an email that is explicitly published on the agency's Idealista profile or verified public website, together with emailSourceUrl.

🚀 Start your first run

1. Open the Actor's Input tab.
2. In What do you want to collect?, choose Fast, Full details or Agency leads.
3. Paste an Idealista search URL or individual listing URL.
4. Set Max items so the run cannot collect more properties than you need.
5. Press Start.

That is enough for most runs. The default settings include phone enrichment and duplicate removal.

Example: 50 fast Madrid listings

{
  "workflow": "FAST",
  "searchUrls": [
    { "url": "https://www.idealista.com/en/venta-viviendas/madrid-madrid/" }
  ],
  "maxItems": 50
}

Example: full details from listing URLs

{
  "workflow": "FULL_DETAILS",
  "detailUrls": [
    { "url": "https://www.idealista.com/en/inmueble/100000001/" },
    { "url": "https://www.idealista.pt/en/imovel/30000001/" }
  ],
  "maxItems": 20
}

The IDs above are examples. Replace them with current Idealista listing URLs.

Example: agency lead enrichment

{
  "workflow": "LEADS",
  "searchUrls": [
    { "url": "https://www.idealista.it/en/vendita-case/milano-milano/" }
  ],
  "maxItems": 25,
  "maxAgencySitePages": 2
}

🎯 Inputs without a pasted URL

The Actor can build a search URL for you. Select:

• country: ES, IT or PT;
• operation: SALE, RENT or NEW_DEVELOPMENT;
• locationSlug: the location part from an Idealista URL, such as madrid-madrid;
• optional minPrice and maxPrice.

You can also supply raw listingIds, mixed startUrls, or a datasetId containing property URLs/IDs from an earlier run. URL routing is always automatic: search pages are paginated and individual listings are opened as details. A direct listing URL necessarily returns its available full property record, even when the default Fast workflow is selected.

🗺️ Search coverage

Idealista limits the number of accessible result pages for broad searches. Enable Split by price range when you need more than the visible cap.

The Actor first opens the original search once. It creates price segments only if that search actually exceeds maxPagesPerSearch, stops planning as soon as maxItems is reached, and deduplicates every property by country and ID. Small or empty searches are never expanded into dozens of unnecessary requests.

Coverage information is saved in the run's OUTPUT record instead of the property dataset, so it remains visible without being counted as a property result. Check:

• reportedTotal — listings reported by Idealista;
• rangeCount — finalized price segments;
• itemsPushed — property rows saved;
• truncated — whether a page, item or spending limit prevented complete coverage.

📞 Phone reliability

Available advertiser numbers are included in every workflow. Each result identifies the phone source and whether a number was returned.

Useful fields:

• phone, phoneFormatted, phoneLocal, phonePrefix;
• secondaryPhone;
• phoneSource;
• phoneEnrichmentStatus;
• phoneRequiresLogin when Idealista itself does not reveal the number.

No scraper can manufacture a number that the advertiser does not publish. Empty values are accompanied by a status instead of fabricated data.

📊 Results you can use immediately

Open Properties for a compact overview with a photo, price, size, rooms, location and contact. Switch its table view to Prices, Contacts, Location, Research, Details or Source fields for focused analysis. Agencies contains one row per discovered agency in Leads runs. Run summary explains the saved counts and coverage.

Research field	What it tells you
pricePerSqmCalculated	Listing price divided by the published area
pricePerSqmDifference	Difference from the source’s own price-per-area value
pricePerBedroom	Listing price divided by the published bedroom count
usableAreaRatio	Usable area as a share of the published total area
priceReductionPercent	Reduction where the source publishes both prices
daysSinceUpdate	Days since the source’s last update, not listing age
contactChannels	Available phone, email, website and chat channels
contactSources	Contact values with their source references

These calculations use the collected facts; they are not appraisals or price predictions. Missing inputs never become invented zeroes.

📦 Main output fields

Every dataset row represents one real property. Error diagnostics and coverage reports are kept separately in OUTPUT.

Identity and pricing

propertyId, url, title, subtitle, operation, typology, price, priceValue, currency, priceByAreaValue, previousPriceValue, priceDropAmount, priceDropPercent

Property details

sizeM2, usableAreaM2, plotAreaM2, terraceAreaM2, bedrooms, bathrooms, floorNumber, condition, occupancyStatus, yearBuilt, communityFeesValue, hasLift, hasTerrace, hasBalcony, hasAirConditioning, heatingType

Location and energy

address, neighborhood, district, city, province, country, latitude, longitude, energyConsumptionValue, energyEmissionsValue

Media

thumbnail, photos, photoCount, floorPlanUrls, hasVideo, videoUrl, has3DTour, virtualTourUrl

If a full page cannot be collected, a recovered record is identified by detailFetched: false and a source status. Fields that could not be confirmed remain empty. A full-details add-on is charged only after the property page was collected successfully.

Advertiser and agency leads

advertiserName, advertiserType, advertiserUrl, advertiserLogo, contactName, licenseCode, phone, secondaryPhone, email, emails, emailStatus, emailSourceUrl, agencyWebsite, agencyAddress, agencyPhones, agencySocialUrls, agencyClientSince, agencyListingCount, agencyPublicationQuality

Trimmed example

{
  "_recordType": "property",
  "propertyId": "100000001",
  "title": "Example apartment for sale",
  "priceValue": 450000,
  "currency": "EUR",
  "sizeM2": 90,
  "bedrooms": 2,
  "city": "Example City",
  "advertiserName": "Example Property Agency",
  "phone": "+34 600 000 000",
  "phoneEnrichmentStatus": "available",
  "email": "hello@example-agency.test",
  "emailStatus": "found_on_public_agency_website",
  "emailSourceUrl": "https://example-agency.test/contact",
  "url": "https://www.idealista.com/en/inmueble/100000001/"
}

All people, companies, contacts and IDs in this example are fictional.

✅ Safe behavior

• Invalid input finishes cleanly with status: INVALID_INPUT and a precise explanation in OUTPUT.
• A bad URL does not erase valid results from the same run.
• maxItems caps both Search and Detail collection; maxDetailUrls can apply a stricter Detail-only cap.
• User spending limits are checked after every saved property and configured value event.
• Memory is constrained to 256–1024 MB, with 512 MB as the default.
• Collection stops when the selected spending allowance is reached or the source stops producing new results.

🔄 Choose your export format

The default outputFormat: "extended" keeps the existing user-friendly fields, including formatted price, numerical priceValue and a readable features list.

Choose outputFormat: "idealista" for integrations expecting a numerical price, propertyCode, size, rooms, lowercase country codes and the source-native features object when supplied. displayPrice and displayFeatures retain the readable versions. Source details are also available as _details when collected. Missing source fields remain missing.

Download JSON for nested source objects, or select one of the focused views before exporting CSV or Excel.

⚙️ API compatibility

New integrations only need the workflow field:

• FAST
• FULL_DETAILS
• LEADS

Older saved tasks using mode, dataLevel, includeDetails and includeAgencyContacts remain supported.

Detailed property and unique-agency contact work are implemented as separate chargeable add-on events, allowing richer packages to have transparent prices without making Fast searches expensive.

---

Export your results as JSON, CSV, Excel or through the Apify API.