Idealista Real Estate
Search, filter and enrich real-estate listings from Idealista's catalog across Spain, Portugal and Italy through a clean REST interface. Whether you're building a comparison site, an internal analytics tool, a relocation product or a housing-market dashboard, you can integrate a complete real-estate data layer in minutes. Please contact us if you need a custom package, higher rate limits, or a…
61 subscribers
9.5/10 popularity
381 ms avg latency
81% success rate
20 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 Real Estate endpoints
| Method | Endpoint | Description |
|---|---|---|
| Search | ||
| GET |
getSearchFilters /v1/search/filters |
Returns the filter blocks applicable to a given operation/propertyType/location combination. Useful to generate a dynamic search UI — each block lists the valid filter keys with… |
| GET |
searchListings /v1/search |
Returns a paginated list of real-estate listings matching the requested filters. At least one of `locationIds` or `parentPromotionId` is required. |
| Listings | ||
| GET |
listNewHomes /v1/new-homes |
Returns promotions of newly-built homes for a given location. Supports construction-state flags (`newDevelopmentInProject`, `finished`) and standard price, size and room filters.… |
| GET |
listUsedHomes /v1/used-homes |
Returns resale (second-hand) homes for a given location. Presets `operation=sale`, `propertyType=homes` and excludes new-build units (`newDevelopment=false`). In addition to the… |
| GET |
listRentHomes /v1/rent-homes |
Returns homes (flats, houses, chalets) available for rent for a given location. Presets `operation=rent` and `propertyType=homes`. In addition to the documented query params,… |
| GET |
listLands /v1/lands |
`operation` is fixed to `sale`; land is not available for rent. |
| GET |
listBuildings /v1/buildings |
`operation` is fixed to `sale`. |
| GET |
listPremises /v1/premises |
|
| GET |
listOffices /v1/offices |
|
| GET |
listStorageRooms /v1/storage-rooms |
|
| GET |
listGarages /v1/garages |
|
| Properties | ||
| GET |
getPropertyStats /v1/property/{ad_id}/stats |
Returns visits, favorites, contacts, publication timeline and other usage analytics for an individual listing. |
| GET |
getPropertyDetail /v1/property/{ad_id} |
Returns the full detail payload for a single property listing (flat, house, office, garage, etc). `quality=high` returns 1500px images. If the ad has been deactivated the… |
| Promotions | ||
| GET |
getPromotionDetail /v1/promotion/{promotion_id} |
Returns the full detail payload for a new-build promotion. Same response schema as `/v1/property/{ad_id}`; the response's `propertyType` is `newDevelopments` and… |
| GET |
listPromotionUnits /v1/promotion/{promotion_id}/units |
Anuncios individuales dentro de una promoción obra nueva. Por dentro llama a la búsqueda con `parentPromotionId` y `propertyType=homes`, y acepta el subconjunto curado de filtros… |
| Locations | ||
| POST |
resolveShortUris /v1/locations/by-shorturis |
Translates bracketed short codes into full locationIds consumable by `/v1/search`. |
| GET |
autocompleteLocations /v1/locations/autocomplete |
Resolves a free-text query (city, neighborhood, street) into locationIds. Useful as a first step before hitting `/v1/search`. |
| GET |
listLocationChildren /v1/locations/{location_id}/children |
Returns provinces→municipalities→districts under a given locationId. |
| GET |
reverseGeocodeLocation /v1/locations/by-coordinates |
Given a WGS84 coordinate, returns the administrative chain (country → province → municipality → district → neighborhood) as locationIds. |
| GET |
listSpanishRegions /v1/locations/regions |
Devuelve las 17 comunidades autónomas más Ceuta y Melilla, cada una con la lista de `locationId` de provincias usables en `/v1/search`. Mapa estático: no hay llamada upstream.… |
Idealista Real Estate pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $21.99 / month | — |
|
| ULTRA Recommended | $44.99 / month | — |
|
| MEGA | $87.99 / month | — |
|
