🏠 Idealista API Scraper

Fast, reliable property scraper for Idealista.com, Idealista.pt, and Idealista.it . Optimized for speed and accuracy with multi-country support.

Now supports both individual property URLs and listing/search URLs!

• A short guide on how to use Idealista API Scraper Actors :

---

🎯 What This Actor Extracts

Complete property intelligence from Idealista listings:

📋 Core Property Data

• Property Details: ID, title, description, address, and web link
• Pricing: Price amount with currency formatting (€/month or €)
• Specifications: Rooms, bathrooms, constructed area, usable area
• Property Type: Extended property type (flat, house, villa, etc.)
• Status: Active/inactive listing status
• Listing Updates: Last modification timestamp

🖼️ Visual Content

• Image Gallery: High-resolution property photos with captions
• Thumbnail: Primary property image
• Multimedia: Video content when available
• Professional Photos: Idealista-made professional imagery
• 360° Tours: Virtual tour availability

🏢 Location & Contact

• Address: Full street address with administrative levels
• GPS Coordinates: Latitude and longitude for mapping
• Location Details: City, region, district information
• Contact Name: Property owner or agent name
• Phone Number: Contact phone with country code
• User Type: Private owner or professional agent
• Communication: Chat and form availability

🏗️ Building & Amenities

• Building Features: Elevator, parking availability
• Exterior Access: Garden, terrace availability
• Condition: Good/bad/unknown property status
• Floor Info: Floor number and building details
• Energy Performance: Energy efficiency when available

⚡ Advanced Features

• Multi-country Support: Spain (.com), Portugal (.pt), Italy (.it)
• Auto Language Detection: Extracts language from URL
• Auto Country Routing: Detects correct API endpoint
• Mixed URL Support: Property URLs and listing/search URLs in one request
• Listing URL Parsing: Automatic search payload generation via deeplinks API
• Configurable Results: Control max properties per listing URL
• Error Tracking: Failed items with detailed error messages
• Pagination Support: Multi-page property collection
• Real-time Streaming: NDJSON format in Standby mode

---

🌐 Supported URL Types

Individual Property URLs

Extract data from a single property page:

• https://www.idealista.com/en/inmueble/82100417/
• https://www.idealista.pt/fr/imovel/33939171/
• https://www.idealista.it/it/immobile/34613312/

Listing/Search URLs (NEW in v3.3)

Scrape multiple properties from a search results page:

• https://www.idealista.com/en/venta-viviendas/balears-illes/?ordenado-por=precios-asc
• https://www.idealista.pt/fr/comprar-casas/nordeste/achadinha/
• https://www.idealista.it/pt/vendita-case/alice-castello-vercelli/

The actor automatically detects which type of URL you provide and handles each accordingly.

---

📊 Two Operation Modes

⚡ NORMAL Mode (Batch Processing)

Process property URLs and listing URLs in a single actor run:

{
  "Property_urls": [
    { "url": "https://www.idealista.com/en/venta-viviendas/balears-illes/?ordenado-por=precios-asc" },
    { "url": "https://www.idealista.com/en/inmueble/82100417/" },
    { "url": "https://www.idealista.pt/fr/imovel/33939171/" },
    { "url": "https://www.idealista.it/it/immobile/34613312/" }
  ],
  "desiredResults": 10
}

In this example, the actor returns:

• Up to 10 properties from the listing URL (/venta-viviendas/balears-illes/)
• 1 property each from the 3 individual property URLs
• Total: up to 13 properties

Output: Dataset with complete property data for all URLs

---

ACTOR STANDBY

🔄 STANDBY Mode (Real-Time API)

Keep the actor running as an HTTP server for instant property extraction:

Traditional Run:

1. ⏳ Start actor (10-30 seconds)
2. 🔍 Extract property (5-15 seconds)
3. 📊 Return results
4. 🛑 Actor stops

Standby Mode:

1. 🔍 Extract instantly (5-15 seconds)
2. 📊 Return results immediately
3. 🔄 Stay ready for next request

Response: 3x faster with zero startup overhead!

Standby Endpoint Example:

curl -X POST https://dz-omar--idealista-scraper-api.apify.actor/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -d '{
    "Property_urls": [
      { "url": "https://www.idealista.com/en/venta-viviendas/balears-illes/" },
      { "url": "https://www.idealista.com/en/inmueble/82100417/" }
    ],
    "desiredResults": 10
  }'

---

✅ Input Schema

Input Fields:

Field	Type	Required	Default	Description
Property_urls	array	✅ Yes	—	Array of property or listing URLs
desiredResults	integer	No	10	Max properties per listing URL (min: 10)

Example Input (Mixed URLs):

{
  "Property_urls": [
    { "url": "https://www.idealista.com/en/venta-viviendas/balears-illes/?ordenado-por=precios-asc" },
    { "url": "https://www.idealista.com/en/inmueble/82100417/" },
    { "url": "https://www.idealista.pt/fr/imovel/33939171/" },
    { "url": "https://www.idealista.it/it/immobile/34613312/" }
  ],
  "desiredResults": 11
}

How it works:

• The listing URL (/venta-viviendas/...) returns up to desiredResults (11) properties
• Each property URL (/inmueble/, /imovel/, /immobile/) returns exactly 1 property
• Total output: up to 14 properties (11 + 3)

STANDBY Mode Input:

Same format, sent as POST body to the standby endpoint.

---

📤 Sample Output

Successful Extraction:

{
  "adid": 82100417,
  "price": 500,
  "priceInfo": {
    "amount": 500,
    "currencySuffix": "€/month"
  },
  "operation": "rent",
  "propertyType": "homes",
  "extendedPropertyType": "flat",
  "ubication": {
    "title": "Calle Everluz, 1",
    "latitude": 37.1827492,
    "longitude": -6.9736586,
    "administrativeAreaLevel2": "Punta Umbria",
    "administrativeAreaLevel1": "Huelva"
  },
  "moreCharacteristics": {
    "roomNumber": 1,
    "bathNumber": 1,
    "constructedArea": 60,
    "usableArea": 55,
    "exterior": true,
    "lift": true,
    "garden": true,
    "status": "good"
  },
  "multimedia": {
    "images": [
      {
        "url": "https://img4.idealista.com/...",
        "tag": "terrace",
        "localizedName": "Terrace"
      }
    ],
    "videos": []
  },
  "contactInfo": {
    "contactName": "juani",
    "userType": "private",
    "phone1": {
      "formattedPhoneWithPrefix": "+34 608 12 39 91"
    },
    "professional": false
  },
  "detailWebLink": "https://www.idealista.com/inmueble/82100417/",
  "country": "es",
  "status": "success",
  "scrapedAt": "2026-02-04T12:30:45.123Z"
}

Failed Extraction:

{
  "url": "https://www.idealista.com/en/inmueble/invalid/",
  "propertyId": null,
  "status": "failed",
  "error": "Could not extract property ID from URL",
  "scrapedAt": "2026-02-04T12:30:45.123Z"
}

---

🔐 Authentication & Proxy

Proxy Configuration

Free Users:

Automatic Apify residential proxy (no configuration needed)

Paid Users:

Premium proxy

Stream Results to File

curl -X POST "https://dz-omar--idealista-scraper-api.apify.actor?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "Property_urls": [
      {"url": "https://www.idealista.com/en/venta-viviendas/balears-illes/"},
      {"url": "https://www.idealista.com/en/inmueble/82100417/"}
    ],
    "desiredResults": 20
  }' > property_data.ndjson

Health Check

$curl -X GET "https://dz-omar--idealista-scraper-api.apify.actor?token=YOUR_APIFY_TOKEN/health"

Using Token in Query Parameter

curl -X POST "https://dz-omar--idealista-scraper-api.apify.actor?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "Property_urls": [
      {"url": "https://www.idealista.com/en/inmueble/82100417/"}
    ]
  }'

---

🎯 Perfect For

Single Property Analysis:

• 🧑‍💼 Real estate agents evaluating listings
• 📈 Investors analyzing specific properties
• 🔍 Content creators gathering data
• 🤖 Developers building automation
• 📱 Apps requiring property lookups

Bulk Operations:

• 📊 Market research and trend analysis
• 🏢 Agency monitoring and tracking
• 📈 Investment portfolio management
• 🔄 Automated listing updates
• 🗺️ Regional property scanning via listing URLs

---

📈 Performance Metrics

Metric	Value
Typical Response Time	5-15 seconds per property
Standby Startup	0 seconds (pre-loaded)
API Success Rate	99%+
Retry Coverage	3 automatic attempts
Memory Usage	128-512 MB configurable
Concurrent Requests	Full rate limit support

---

🏗️ Architecture Highlights

STANDBY Mode Implementation:

• Express.js HTTP server
• NDJSON streaming responses
• Mixed URL handling (property + listing)
• Real-time progress updates
• Graceful error handling
• Automatic batch processing

Listing URL Processing:

• Deeplinks API integration for URL → payload conversion
• Automatic pagination with configurable limits
• Batch streaming in STANDBY mode

Data Quality:

• 6 optimized dataset views
• Field validation
• Error tracking
• Status indicators
• Timestamp tracking

---

📊 Status Codes

Status	Meaning	Action
success	Property extracted successfully	Use data
failed	Extraction failed	Check error message
migrating	Server is migrating	Retry request
aborting	Server shutting down	Restart actor

---

💡 Pro Tips

1. Use Standby for real-time needs - 3x faster response
2. Mix URL types - Combine property and listing URLs in one request
3. Set desiredResults wisely - Higher values = more data but longer runtime
4. Batch requests efficiently - Multiple URLs in one call
5. Monitor error view - Catch issues early

---

🤝 Support & Resources

📞 Support

Get Help

• 🌐 Website: flowextractapi.com
• 📧 Email: flowextractapi@outlook.com
• 🙋 Apify Profile: FlowExtract API
• 💬 GitHub Issues: FlowExtractAPI

Social Media

• 💼 LinkedIn: flowextract-api
• 🐦 Twitter: @FlowExtractAPI
• 📱 Facebook: flowextractapi

🌟 Related Actors by FlowExtract API

🎬 Video & Media

• YouTube Transcript Extractor - Extract transcripts with timestamps
• YouTube Scraper Pro - Complete channel and playlist extraction
• Zoom Scraper - Download recordings and transcripts
• Loom Scraper - Loom video and transcript extraction

🏠 Real Estate

• Idealista Scraper API - Spanish property data with API
• Idealista Scraper - Real estate listings extractor

📚 Education & Community

• Skool Scraper Pro Lessons, videos, posts, and attachments from Skool classrooms
• Skool Map Scraper Member locations and profiles from Skool community maps

🛠️ Developer Tools

• Screenshot - Fast webpage screenshots
• Ultimate Screenshot - Advanced screenshot tool
• Network Security Scanner - Security vulnerability scanner

📱 Social Media

• Facebook Ads Scraper Pro - Extract Facebook ads data

---

⚖️ Legal & Compliance

• Public Data Access: Only processes publicly available data
• Rate Limiting: Respects service limits and terms of use
• Data Protection: No storage of personal information or unauthorized data collection
• Commercial Use: Suitable for business intelligence and research applications

---