Idealista Property Detail Scraper

Get the full idealista listing page of properties in Spain (idealista.com), Italy (idealista.it) and Portugal (idealista.pt) as clean structured JSON: title, location line, operation and property type, price (monthly for rentals), original price and price drop, price per m2, the price breakdown idealista shows (community fees, deposit ...), built and usable area, rooms, bathrooms, floor, lift, parking, every feature group as idealista lists it (specific features, building, equipment, energy certificate), year built, energy rating, description, address lines, coordinates (flagged when the advertiser hides the exact spot), the whole photo gallery with captions, floor plans, plan / video / 3D tour counts and the advertiser (name, type, reference, agency page, logo). No idealista account, no API key, no proxies to configure.

Features

• Three countries - idealista.com, idealista.it and idealista.pt.
• Any listing input - a listing URL or the numeric listing id with its country.
• Or read the listings of a search - give idealista search URLs (with their filters) and the top listings of each search are read in full.
• Everything on the page - feature groups, price breakdown, address, coordinates, full gallery with captions and sizes, floor plans, advertiser and the last-updated note.
• Removed listings are free - a listing its advertiser took down comes back in ERRORS with the removal date when idealista shows one, and is not billed.
• Deduplicated - the same listing given twice (id and URL, or found by two searches) is read once.

Searching many listings? Our Idealista Scraper returns search results (price, area, rooms, agency) at a lower price per listing; feed the listing URLs you need in full to this actor.

Use cases

• Property valuation - area, rooms, bathrooms, floor, energy rating, year built and price per m2 for comparables.
• Investment due diligence - community fees, deposits, condition and features before a viewing.
• Geo analysis - coordinates and address lines for mapping listings.
• Listing monitoring - re-read listings to track price changes and removals.

Input

Field	Type	Default	Description
listings	array	-	idealista listing URLs or numeric ids.
country	string	es	Site of numeric ids: es, it or pt.
searchUrls	array	Lisbon sales (example)	Optional idealista search URLs; their top listings are read in full.
maxListingsPerSearch	integer	5	Listings read per search URL (1-300).
proxyCountry	string	-	Optional exit-IP country (ISO-2). Leave empty for the most reliable exit.
concurrency	integer	2	Listings read at the same time (1-3).

Example input

{
  "listings": [
    "https://www.idealista.pt/imovel/34665653/",
    "https://www.idealista.it/immobile/37068709/"
  ],
  "searchUrls": ["https://www.idealista.pt/arrendar-casas/porto/"],
  "maxListingsPerSearch": 20
}

Output

One dataset item per listing (shortened):

{
  "id": "34665653",
  "url": "https://www.idealista.pt/imovel/34665653/",
  "title": "Apartamento T2 à venda na Rua da Beneficência, 100",
  "locationLine": "Entrecampos, Avenidas Novas",
  "operation": "sale",
  "propertyType": "home",
  "priceText": "660.000 €",
  "price": 660000,
  "currency": "EUR",
  "area": 151,
  "areaType": "área bruta",
  "rooms": 2,
  "bathrooms": 2,
  "floor": "Rés do chão sem elevador",
  "lift": false,
  "parking": "included",
  "features": [
    {"group": "Características específicas", "items": ["151 m² área bruta", "T2", "2 casas de banho", "Terraço e varanda"]},
    {"group": "Prédio", "items": ["Rés do chão", "Sem elevador"]}
  ],
  "priceDetails": {"Preço do imóvel": "660.000 €", "Preço por m²": "4.371 €/m²"},
  "pricePerM2": 4371,
  "description": "T2 com logradouro nas Avenidas Novas | Exterior privado e elevada procura ...",
  "address": ["Rua da Beneficência, 100", "Entrecampos", "Avenidas Novas", "Lisboa"],
  "coordinates": {"latitude": 38.7436535, "longitude": -9.157716},
  "images": [{"url": "https://img4.idealista.pt/blur/WEB_DETAIL/0/id.pro.pt.image.master/18/79/fd/321088422.jpg", "caption": "Sala de estar", "width": 1500, "height": 1000}],
  "floorPlans": [{"url": "https://img4.idealista.pt/blur/WEB_DETAIL/0/id.pro.pt.image.master/86/26/9d/303171204.jpg", "caption": "Planta", "width": 469, "height": 655}],
  "multimediaCounts": {"PICTURE": 27, "PLAN": 2, "VIRTUAL_TOUR_3D": 1, "VIDEO": 2},
  "advertiser": {
    "name": "FLIPSTONE",
    "type": "Promotora",
    "reference": "34665653",
    "agencyUrl": "https://www.idealista.pt/pro/flipstone/",
    "logo": "https://st3.idealista.pt/7b/4c/df/flipstone.gif"
  },
  "updated": "Anúncio atualizado no dia 6 de Julho",
  "country": "pt",
  "listingInput": "https://www.idealista.pt/imovel/34665653/",
  "searchUrl": null
}

Fields idealista does not show for a listing (year built, energy rating, usable area ...) are left out. The key-value store also holds ERRORS - listings and search URLs that returned no listing (removed, unknown, blocked) with the reason. These are not billed.

Pricing

$1.00 per 1000 listings, each a full listing page. You pay only for listings delivered; removed or failed listings are not charged, and the search step is free.

Notes

• Texts come in the site's language (Spanish, Italian, Portuguese); prices are in EUR.
• locationApproximate is true when the advertiser hid the exact address; the coordinates are then the area's centre.