Idealista Scraper API avatar
Idealista Scraper API

Pricing

Pay per event

Go to Store
Idealista Scraper API

Idealista Scraper API

Developed by

dz_omar

dz_omar

Maintained by Community

Extracts structured property data (price, features, contact info, images) from any Idealista.com/.pt/.it listing URL. Outputs clean JSON for real estate analysis, market research, and automation workflows. Handles anti-bot protections automatically.

4.8 (5)

Pricing

Pay per event

5

Total users

26

Monthly users

26

Runs succeeded

>99%

Last modified

24 days ago

๐Ÿ˜๏ธ Idealista Property Scraper (Single URL)

Extract high-quality real estate data from one Idealista property listing at a time across Spain, Portugal, and Italy.

Perfect for real estate analysts, content creators, investors, and SEO professionals looking to extract structured property data from Idealista without needing to code or browse endlessly.


๐Ÿ”Ž What This Actor Does

This scraper gives you full property details from a single listing page, including:

  • ๐Ÿ“Œ Title, description, and address
  • ๐Ÿ’ฐ Price
  • ๐Ÿ“ Area, number of rooms and bathrooms
  • ๐Ÿ–ผ๏ธ Image gallery
  • ๐Ÿข Agency details and contact info
  • ๐Ÿ“ GPS map coordinates
  • ๐Ÿ”ง Features like terrace, elevator, AC, etc.

Just paste in one property URL and run โ€” the actor will return rich, structured data in seconds.


โš™๏ธ One URL Per Run

This actor is built for one listing per run. Want to extract 10 listings? Just call the actor 10 times โ€” either manually or automatically.

โš ๏ธ Ideal for automation: developers can loop through multiple URLs and call this actor via API (details shown in Apify automatically).


๐Ÿ”— Need Bulk Extraction?

Looking to scrape hundreds or thousands of properties at once?

Check out our Idealista Bulk Property Scraper which:

  • ๐Ÿš€ Processes multiple search URLs in a single run
  • ๐Ÿ“ˆ Extracts unlimited properties (bypasses Idealista's 1,800-property limit)
  • ๐Ÿค– Uses this API internally for individual property extraction
  • ๐Ÿ’ฐ More cost-effective for large-scale operations

The bulk scraper automatically calls this single-property API for each listing, making it perfect for market analysis, competitor research, and large datasets.


๐ŸŒ Supported Domains

You can use this actor on any public Idealista property URL such as:

  • https://www.idealista.pt/en/imovel/33826216/
  • https://www.idealista.com/en/inmueble/106316721/
  • https://www.idealista.it/en/immobile/12345678/

๐Ÿ’ก Who Is This For?

Single Property Analysis:

  • ๐Ÿง‘โ€๐Ÿ’ผ Real estate agencies analyzing specific listings
  • ๐Ÿ“ˆ Investors evaluating individual properties
  • ๐Ÿ” Content creators gathering specific property data
  • ๐Ÿค– Developers building targeted automation
  • ๐Ÿ“ฑ Apps requiring individual property lookups

Bulk Operations:


โœ… Sample Input

Only one field is needed: a property URL.

{
"Url": "https://www.idealista.pt/en/imovel/33532602/",
"proxyConfig": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}

๐Ÿ“Š Sample Output

{
"id": "33826216",
"title": "T2 flat for sale in Ponta Delgada",
"price": "399,950 โ‚ฌ",
"description": "Come and discover this amazing apartment...",
"location": "Ponta Delgada",
"characteristics": ["239 mยฒ built", "2 bathrooms", "Terrace"],
"building": ["With lift"],
"amenities": ["Air conditioning"],
"propertySpecs": {
"rooms": 2,
"bathrooms": 2,
"constructedArea": 239
},
"contactInfo": {
"agency": "Comprarcasa Ponta Delgada",
"phones": "+351 296 091 683",
"logo": "https://st3.idealista.pt/e0/de/bb/httpwwwcomprarcasaptlojapontadelgada.gif"
},
"gallery": [
{
"url": "https://img4.idealista.pt/blur/WEB_DETAIL/0/id.pro.pt.image.master/20/ea/c7/267138555.jpg",
"tag": "Views",
"isPlan": false
}
],
"scrapedAt": "2025-05-26T19:41:01.534Z",
"status": "success"
}

๐Ÿ”ง Integration & Automation

API Integration

This actor is designed to be called programmatically:

// Example: Scraping multiple properties in a loop
const propertyUrls = [
"https://www.idealista.pt/en/imovel/33826216/",
"https://www.idealista.com/en/inmueble/106316721/",
"https://www.idealista.it/en/immobile/12345678/"
];
for (const url of propertyUrls) {
const run = await apifyClient.actor("dz_omar/idealista-scraper-api").call({
Url: url,
proxyConfig: { useApifyProxy: true, apifyProxyGroups: ["RESIDENTIAL"] }
});
const { items } = await apifyClient.dataset(run.defaultDatasetId).listItems();
console.log(items[0]); // Property data
}

Used by Bulk Scraper

The Idealista Bulk Property Scraper uses this API internally to:

  1. Process search result pages
  2. Navigate through property listings
  3. Extract detailed data from each property
  4. Aggregate results into comprehensive datasets

๐Ÿ“š Documentation

Proxy Requirements

Proxies are required for reliable operation. Recommended configuration:

"proxyConfig": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}

๐Ÿ’ฐ Pricing

Single Property Extraction:

  • Actor Initialization: $0.001 per run
  • Property Data Extracted: $0.002 per successful extraction
  • Total: $0.003 per property

Bulk Operations:

For extracting multiple properties, consider the Idealista Bulk Scraper which offers:

  • One-time setup fee of $0.005
  • Same $0.003 per property cost
  • Automated workflow management
  • Resume capability for large extractions

This actor:

  • Respects robots.txt directives
  • Implements rate limiting to avoid server overload
  • Only extracts publicly available data
  • Does not bypass paywalls or login requirements

๐Ÿค Support & Contact

For assistance or custom implementations: