Idealista
Idealista API endpoints
Available Idealista Endpoints
Explore 11 endpoints for accessing Idealista real estate data. Each endpoint is designed for a specific use case and returns structured JSON.
/details/byid/details/byid
Get **full Idealista property details** by `propertyCode` — the digit-only id you find on every listing URL (`idealista.com/inmueble/<propertyCode>/`). Returns price, currency, address (when shown), photos, agent / agency contact, energy certification, more-characteristics block, year of construction, community costs, lift, neighborhood, latitude/longitude, raw description in the original language plus translated copies, deeplink and share URLs. If you only have a listing URL, use [/details/byurl](https://realtyapi.io/dashboard?tab=playground&api=idealista&endpoint=detailsbyurl) instead.
/details/byurl/details/byurl
Get full property details from any Idealista listing URL — Spain `/inmueble/<id>/`, Italy `/immobile/<id>/`, Portugal `/imovel/<id>/`, plus new-development URLs `/obra-nueva/<id>/`. The country is auto-detected from the host (`idealista.com`/`.es` → Spain, `.it` → Italy, `.pt` → Portugal); the same fields are returned as [/details/byid](https://realtyapi.io/dashboard?tab=playground&api=idealista&endpoint=detailsbyid).
/autocomplete/autocomplete
Idealista **location typeahead**. Returns matching cities, provinces, districts, neighborhoods, metro stops and addresses with their `locationId` (e.g. `0-EU-ES-28-07-001-079` = Madrid municipality), parent breadcrumbs and result-count hints. Use the returned `locationId` as input to [/search/bylocation](https://realtyapi.io/dashboard?tab=playground&api=idealista&endpoint=searchbylocation) for an exact-area search.
/search/bylocation/search/bylocation
Search Idealista listings by **free-text city / neighborhood / district name**. The query is resolved through [/autocomplete](https://realtyapi.io/dashboard?tab=playground&api=idealista&endpoint=autocomplete) to a `locationId` and the search runs against that. If you already have a `locationId` from a prior `/autocomplete` call, pass it directly via the `locationId` parameter to skip the resolution step. Supports the **full Idealista filter vocabulary** below (price/size ranges, bedrooms, owner type, amenity booleans, short-term-rental dates, condition, floor, sort, pagination).
/search/byzip/search/byzip
Search Idealista listings by **postal code** (Spain / Italy / Portugal). The ZIP is resolved through `/autocomplete` to find the matching district `locationId`, then the same search pipeline as [/search/bylocation](https://realtyapi.io/dashboard?tab=playground&api=idealista&endpoint=searchbylocation) is executed.
/search/bycoordinates/search/bycoordinates
Search Idealista listings inside a **circular area** defined by lat / lon + radius (km). The circle is converted to a bounding-box GeoJSON polygon and passed to Idealista's `shape` filter.
/search/bypolygon/search/bypolygon
Search Idealista listings inside an **arbitrary polygon** — useful for hand-drawn map searches. Accepts either a `'lon lat,lon lat,...'` string OR a JSON list of `[lon, lat]` pairs OR a complete GeoJSON `{"type":"Polygon","coordinates":[...]}`. Coordinates are GeoJSON-style `[longitude, latitude]`.
/search/byurl/search/byurl
Run the search that an **Idealista search URL** represents — paste any browser URL like `https://www.idealista.com/en/venta-viviendas/madrid-madrid/` and the same listings come back. The URL is parsed via Idealista's `shorturis/by-locations` endpoint to extract the `locationId` + filters; country and operation (`venta`/`vendita`/`comprar` = sale, `alquiler`/`affitto`/`arrendar` = rent) are auto-detected from the URL.
/locations/sublocations/locations/sublocations
Drill down from a parent `locationId` to its **direct child zones** (province → comarcas → municipalities → districts → neighborhoods). Useful for building a location-picker UI without hitting the typeahead. **Example**: `locationId=0-EU-ES-28` (Madrid province) returns the comarcas inside it; pass any of those back to drill another level.
/agent/details/agent/details
Get a **real-estate agency's full microsite profile** by `micrositeShortName` — commercial name, contact info (phone, email, address, logo), website URL, default operation/typology, supported languages, total active listings, year active since. Find the `micrositeShortName` on any listing's `contact.micrositeShortName` field.
/agent/locations/agent/locations
Get the **geographies (provinces, municipalities, districts) where an agency has active listings**, with per-location listing counts. Each result has `name`, `locationId`, `level` (`province` / `municipality` / `district` / `neighborhood`), and `total`.
Why Choose RealtyAPI for Idealista Data
We built RealtyAPI so developers can focus on their products, not on data collection infrastructure.
Real-Time Data Access
Get the most current Idealista data without dealing with rate limits, IP blocks, or anti-bot protections. Our infrastructure handles the heavy lifting.
Simple Integration
Clear documentation and a straightforward REST API make it easy to start pulling Idealista data into your application within minutes.
High Reliability
Our infrastructure is built for uptime and performance. Rely on consistent, uninterrupted access to Idealista data for your production applications.
Comprehensive Data
Access a wide range of Idealista data points through carefully designed endpoints that cover properties, listings, agents, and market metrics.
Lightning Fast Responses
Optimized data pipelines deliver Idealista results in milliseconds. Low latency means a better experience for your end users.
Structured JSON Output
Every Idealista endpoint returns clean, well-structured JSON that is ready to parse and use directly in your application logic.
Idealista API Use Cases
From property valuation to market analysis, the Idealista powers a wide range of real estate applications.
Property Valuation
Analyze Idealista property data to determine accurate market values, estimate appreciation, and identify undervalued investment opportunities.
Market Research
Track Idealista listing trends, pricing shifts, and inventory changes to make informed, data-driven investment and development decisions.
Portfolio Management
Monitor your real estate portfolio with live Idealista data. Track current values, rental comps, and market conditions in one place.
Lead Generation
Identify high-potential properties and neighborhoods using Idealista data to power targeted outreach and marketing campaigns.
Competitive Analysis
Compare listings, pricing, and agent activity across Idealista to understand market positioning and stay ahead of competition.
Custom Dashboards
Build real-time dashboards that aggregate Idealista data for internal teams, clients, or investors with always-current information.
Frequently Asked Questions
Common questions about using the Idealista through RealtyAPI.
Is the Idealista API official?
How current is the data?
Can I use this API in production?
What response format does the API use?
Do I need a credit card to get started?
What programming languages are supported?
Ready to Access Idealista Data?
Get started with 250 free API calls. No credit card required.