Idealista Scraper

Idealista Scraper: property listings from Spain, Italy and Portugal, no account needed

Paste an Idealista search URL straight out of your browser, or describe the search with country, location, buy or rent, price and size. Every listing comes back as a row: price, price per m2, size, rooms, floor, address, neighbourhood, whether the advertiser is an agency or a private seller, the photos and the link.

One thing to decide up front. Bathrooms, the full description and the whole photo gallery live on the listing page, not on the search results, so getting them means opening every listing and a run that takes roughly ten times longer.

🏠 What Idealista Scraper does

Three country sites, one set of columns: idealista.com for Spain, idealista.it for Italy and idealista.pt for Portugal. A row from Madrid and a row from Milan have the same keys.

There are two ways to ask. The precise one is a search URL: run the search on the site, get it looking right, copy the address bar. Every filter already in that URL is kept, including the ones this actor has no field for. Up to 20 URLs in a run.

The other way is the filter fields. Leave the URL list empty, pick a country, an operation and a location slug, and the run builds the search for you. Only the location is required. The slug is the piece Idealista itself uses in the address, like madrid-madrid, barcelona-barcelona, milano-milano or lisboa.

📥 What you give it

Every field is optional. Run it with the input empty and you get one labelled sample row back.

{
  "searchUrls": [
    "https://www.idealista.com/venta-viviendas/madrid-madrid/",
    "https://www.idealista.it/affitto-case/milano-milano/"
  ],
  "maxItems": 200
}

Idealista Italy has no bedroom filter in its URLs. Set minRooms on an Italian search and the run tells you it was dropped, with a FILTER_UNSUPPORTED row, rather than pretending it applied it. Same story for commercial premises, garages and land outside Spain: paste a search URL instead.

The sort order and must-have options work on homes, in the filter fields only. A URL in searchUrls, or an option that country's site lacks, stops the run with a free BAD_INPUT row before anything is fetched, so you never pay for the search without it.

📤 What you get back

A real row, from run WRZcZ8cP4XevFvEST:

{
  "ok": true,
  "charged": true,
  "recordType": "listing",
  "listingId": "106387165",
  "title": "Penthouse in Calle de Alcalá, 145, Goya, Madrid",
  "price": 3390000,
  "currency": "EUR",
  "priceLabel": "total",
  "pricePerM2": 12890,
  "sizeM2": 263,
  "rooms": 4,
  "bathrooms": null,
  "floor": "5th floor exterior with lift",
  "hasLift": true,
  "address": "Calle de Alcalá, 145, Goya, Madrid",
  "neighbourhood": "Goya",
  "city": "Madrid",
  "country": "Spain",
  "operation": "buy",
  "propertyType": "Penthouse",
  "advertiserType": "agency",
  "agencyName": "Walter Haus Madrid",
  "description": "We present to you EXCLUSIVELY a unique property on the top floor of a royal ...",
  "features": [],
  "tags": ["Luxury"],
  "images": ["https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/b3/28/..."],
  "imageCount": 1,
  "listingUrl": "https://www.idealista.com/inmueble/106387165/",
  "searchUrl": "https://www.idealista.com/venta-viviendas/madrid-madrid/",
  "updatedText": null,
  "scrapedAt": "2026-09-21T01:37:54.388Z"
}

That row came without the detail pass, so bathrooms is null, there is one photo, and the description is the card's shortened one.

🧾 Reading the output

Three kinds of row.

charged is set when the row is built, a moment before the charge goes out, so read it as "this is a real row" rather than as a receipt. A failed charge adds a CHARGE_ERROR diagnostic at the end.

The Console's default table has no column for errorCode, so diagnostics look like blank lines there. Download the JSON to read them.

▶️ How to run it

1. Run your search on idealista.com, .it or .pt until the results look right, then copy the address. 2. Open Idealista Scraper, click Try for free, and paste it into Idealista search URLs. 3. Or leave that empty and fill in Country, Buy or rent and Location. 4. Set Maximum listings. Keep it low on the first run. 5. Click Start, then download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$1.20 per 1,000 listings. The same rate on every Apify plan, with no volume tiers.

One charge per listing row. A property that turns up in two of your searches is charged once. Promoted slots and advert blocks that are not real listings are dropped before anything is billed, and neither the sample row nor any diagnostic row is charged. Turning on the detail pass does not change the price per listing.

💡 What people use it for

• Tracking asking prices in a neighbourhood week by week, keyed on listingId.
• Pulling comparables before valuing or pricing a property.
• Splitting a market by advertiserType to see what share is agency stock and what is private.
• Watching rentals in one city across all three countries in a single sheet.

🚧 What it does not do

• No contact details. No phone numbers, no email addresses. agencyName is the name only.
• No coordinates. Address, neighbourhood and city, as published.
• bathrooms and the full description need the detail pass. Without it, bathrooms are null and

the description is the shortened card version.

• updatedText is usually null, because most listings do not publish one.
• minRooms does not work on Italy. That country's search URLs have no bedroom filter.
• No newest-first order. Rows carry no date to check it by.
• Commercial premises, garages and land are Spain only in the filter fields. Use a search URL for

the others.

• About 1,800 listings per search, because the site stops paging at 60 pages. Split a big area

into smaller searches, by district or by price band, to get past it.

• 20 search URLs and 3,000 listings in one run.
• Current listings only. No sold prices, no history, no archive of what a flat used to ask.
• Photos are the URLs Idealista serves, not downloaded files.

🧭 Which property scraper do you need?

❓ Questions people ask

Do I need an Idealista account or an API key? No. Nothing to paste in, nothing to renew.

Which is better, a URL or the filter fields? A URL, every time. It keeps filters this actor has no field for, and it is exactly the search you already checked on the site.

Where do I find the location slug? In the address bar after you search on Idealista. In https://www.idealista.com/venta-viviendas/madrid-madrid/ the slug is madrid-madrid.

Can I mix countries in one run? Yes, by putting URLs from different Idealista sites in searchUrls. Each row says which country it came from.

Why did I get fewer listings than I asked for? Either the search has that many, or it reached the 60-page limit. Split the area into smaller searches and run them together.

Is this legal? These are public listing pages. Rows carry agency names and property addresses, which data-protection law can cover, so have a reason for collecting them. Apify's write-up on scraping and the law is a fair start, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the run ID and the exact search URL or filters you used. A diagnostic row's errorCode and searchUrl usually name the search that went wrong.