Skip to main content
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.

Active2 credits = 1 requestGET/v2/idealista/property

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 browser rendering.

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.

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