Skip to main content
Network status
Log in
Piloterr
Back to library

Idealista Property API

Extract full property details from an Idealista listing URL, including price, specs, photos by room, features, energy rating, and advertiser data.

Active3 credits = 1 requestGET/v2/idealista/property
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Extract comprehensive property details from an Idealista listing page. Returns pricing, title, address, room-by-room photos, floor plans, features, energy rating, description, and advertiser metadata via WebUnlocker.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/idealista/property?query=https://www.idealista.com/fr/inmueble/111463799/

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full Idealista property detail URL

Response fieldsLink to Response fields

Field Type Description
url string Canonical listing URL
title string Listing title
price integer Listing price
currency string | null Currency when available
location string Short location label
address array Address lines (street, district, city)
updated string Last update label
description string Full listing description
plans array Floor plan image URLs
images object Photos grouped by room label
features object Grouped feature strings; may include nested energy rating (emissions, consumption)
units array Related units when available
advertiser_name string | null Agency or advertiser name
advertiser_url string | null Agency profile URL

NotesLink to Notes

  • Only full Idealista /inmueble/ URLs are accepted as query.
  • Feature labels and image room names follow the Idealista page locale.
  • currency, advertiser_name, and advertiser_url may be null on some listings.

Main use casesLink to Main use cases

  • Enrich CRM records with full property specs and agency data
  • Analyze listing features, energy rating, and room layout from photos
  • Extract advertiser attribution for lead routing
  • Power comp tools with price, surface, and location data

Related APIs

Expand your data capabilities with these complementary tools.

View All
Idealista Provinces/v2/idealista/provinces

List the 50 Spanish provinces Idealista shows for homes for sale. Each row includes the sale search URL to pass as query to Idealista Search. Madrid is madrid-provincia.

GET3 credits = 1 requestActive
Idealista Search/v2/idealista/search

Search Idealista listings from a search URL and retrieve prices, specs, photos, agency info, and pagination. Pass a province URL from `/v2/idealista/provinces` (`results[].url`) as `query`. Madrid is `https://www.idealista.com/venta-viviendas/madrid-provincia/`.

GET3 credits = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert