Idealista API
------------------------ `You're in the right place. Just give it a try!` ------------------------ - Realtime-Data exactly like you see on www.idealista.com. - Fastest Idealista API. - Find any property. - Custom endpoint, concurrent requests, priority support. - If you need help using this API for your projects, contact at: `[email protected]`
29 subscribers
9.6/10 popularity
1214 ms avg latency
100% success rate
11 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Idealista API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Property Details | ||
| GET |
/details/byurl /details/byurl |
Get full property details from any Idealista listing URL — Spain `/inmueble//`, Italy `/immobile//`, Portugal `/imovel//`, plus new-development URLs `/obra-nueva//`. The country… |
| GET |
/details/byid /details/byid |
Get **full Idealista property details** by `propertyCode` — the digit-only id you find on every listing URL (`idealista.com/inmueble//`). Returns price, currency, address (when… |
| Search Idealista | ||
| GET |
/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… |
| GET |
/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… |
| GET |
/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]`… |
| GET |
/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… |
| GET |
/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… |
| GET |
/search/bylocation /search/bylocation |
Search Idealista listings by **free-text city / neighborhood / district name**. The query is resolved through… |
| GET |
/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` =… |
| Agents | ||
| GET |
/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`,… |
| GET |
/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… |
Idealista API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $20 / month | 5 / second |
|
| ULTRA | $60 / month | 25 / second |
|
| MEGA Recommended | $250 / month | 50 / second |
|
