🏠 Idealista Scraper by URL

No Proxies Needed

⚠️ Free plan limit: 100 listings per run. Runs started from an Apify free plan account return at most 100 listings, whatever maxPages and result_count are set to. Paid Apify plans get unlimited results. Compare Apify plans.

---

🌟 Overview

The Idealista Scraper by URL is a lightning-fast, production-ready Apify actor designed to extract property listings from Idealista.com / .es / .it / .pt.

Instead of dealing with complex geo-targeting, IP rotation, and anti-scraping blocks, you can simply paste any public Idealista search URL (from your browser address bar, a saved search, or email alert) and get clean structured JSON data back instantly.

📦 Datasets Available for Sale

Dataset	Size & Coverage	Data Included
🏘️ Idealista Property Listings	1M+ listings 🇪🇸 Spain: all cities 🏠 Sale & Rental properties	🏠 Property specifications · 💰 Pricing · 📍 Locations · 🏷️ Listing metadata · 📐 Property attributes · 🛏️ Bedrooms & bathrooms · 📅 Listing data

---

⚡ Ready-to-Use Data

Get 1M+ Idealista property listings covering all cities across Spain, including both properties for sale and rent, structured and ready to use, with no scraping or proxies required.

🌐 Useful Links

• 🌍 HappyEndpoint Website: https://happyendpoint.com/
• 🐦 Twitter: https://x.com/happyendpointhq
• 📩 Contact Email: hello@happyendpoint.com

🚀 Key Features

• No Proxies Needed: The actor utilizes a premium built-in proxy system that handles rotating IPs, browser mimicking, and geo-unlocking natively.
• Multi-Country Support: Auto-detects the region from the URL host (works seamlessly with Spain .es / .com, Italy .it, and Portugal .pt).
• Auto-Pagination: Crawls through multiple result pages sequentially up to your customized limit.
• Description Translations: Translates listing descriptions into your target language (default: en).
• Rich Dataset Export: Downloads comprehensive details including prices, sizes, rooms, bathrooms, address, coordinates, and descriptions.

---

📥 Input Parameters

The actor accepts the following input parameters:

Field	Type	Required	Default	Description
url	String	Yes	None	A public Idealista search URL (e.g., https://www.idealista.com/en/venta-viviendas/madrid-madrid/).
country	Select	No	auto	Override auto-detection. Options: Auto-detect, es (Spain), it (Italy), pt (Portugal).
maxPages	Number	No	5	Maximum number of result pages to crawl and paginate through.
result_count	Number	No	30	Number of listings to fetch per page (1 to 50).
language	String	No	en	Response language code for translating property descriptions.

Example Input JSON

{
    "country": "es",
    "language": "en",
    "maxPages": 1,
    "result_count": 30,
    "url": "https://www.idealista.com/en/venta-viviendas/madrid-madrid/"
}

---

📤 Output Structure

Each listing in the dataset contains clean, parsed fields:

{
  "propertyCode": "106387165",
  "price": 3490000,
  "propertyType": "duplex",
  "operation": "sale",
  "size": 263,
  "rooms": 4,
  "bathrooms": 5,
  "address": "Duplex in Calle de Alcalá, Goya, Madrid",
  "province": "Madrid",
  "municipality": "Madrid",
  "country": "es",
  "url": "https://www.idealista.com/inmueble/106387165/",
  "description": "Top-floor duplex in the Salamanca district..."
}

---

💡 Pro Tips & Usage

1. How to get the URL: Perform any search on Idealista.com, apply your filters (price, bedrooms, location, property type), and copy the final URL from your browser's address bar. Paste it directly into the actor's inputs!
2. Speed & Scale: The actor fetches pages sequentially to respect source limits while completing runs in seconds. Adjust maxPages according to the depth of data you need.
3. Data Export: Once the scraping job is complete, you can download your dataset as JSON, CSV, Excel, or connect it directly to Google Sheets, Webhooks, or other workflow automations.

---

🔗 Related Actors

If you need more than property scraping, check out the other actors in this series:

• Bayut Property Scraper: scrape property listings from Bayut with filters for location, price, type, and more
• Bayut Agent Finder: full agent workflow on Bayut: location search → agent search → agent details → agent's property listings
• Bayut & PropertyFinder Agent Search: find and extract agent profiles from both major UAE portals.

---

📞 Contact & Custom Solutions

Need something specific? We provide tailored web scraping solutions and large-scale datasets.

Contact us for custom data scraping or to purchase UAE real estate historical data.

• Website: happyendpoint.com
• Email: hello@happyendpoint.com

Other Products

• UAE Bayut Data API
• UAE Propertyfinder Data API