--- title: "Idealista API: JSON data, 22 endpoints, 1 credit per call" description: "Get Idealista data as structured JSON with one API key: map search, search, agency and deeplink build. Free credits every month." url: https://perceptlayer.com/apis/idealista --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Idealista 1 credit per call 22 endpoints # Idealista API Get Idealista data as structured JSON with one API key: map search, search, agency and deeplink build. Free credits every month. [Get a free API key](https://perceptlayer.com/signup) Run it below Idealista GET /v1/idealista/search?country=es&operation=sale&property\_type=homes&location\_id=0-EU-ES-28&max\_items=2 ``` curl "https://api.perceptlayer.com/v1/idealista/search?country=es&operation=sale&property_type=homes&location_id=0-EU-ES-28&max_items=2" \ -H "X-API-Key: $API_KEY" ``` cURL 1 credit per successful call Run this call below or from your dashboard to see a live response. Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/idealista/search?country=es&operation=sale&property_type=homes&location_id=0-EU-ES-28&max_items=2" \ -H "X-API-Key: $API_KEY" ``` Idealista ยท 22 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/idealista/agency`](https://perceptlayer.com/apis/idealista/agency) | `country` `microsite_short_name` | 1 credit | | [POST `/v1/idealista/deeplink-build`](https://perceptlayer.com/apis/idealista/deeplink-build) | `country` `location_id` +3 optional | 1 credit | | [GET `/v1/idealista/deeplink-parse`](https://perceptlayer.com/apis/idealista/deeplink-parse) | `country` `url` +1 optional | 1 credit | | [GET `/v1/idealista/filters`](https://perceptlayer.com/apis/idealista/filters) | `country` `operation` `property_type` `location_id` +3 optional | 1 credit | | [GET `/v1/idealista/home`](https://perceptlayer.com/apis/idealista/home) | `country` +2 optional | 1 credit | | [GET `/v1/idealista/listing`](https://perceptlayer.com/apis/idealista/listing) | `country` `ad_id` +9 optional | 1 credit | | [GET `/v1/idealista/listing-multimedia`](https://perceptlayer.com/apis/idealista/listing-multimedia) | `country` `ad_id` +2 optional | 1 credit | | [GET `/v1/idealista/listing-stats`](https://perceptlayer.com/apis/idealista/listing-stats) | `country` `ad_id` +1 optional | 1 credit | | [GET `/v1/idealista/location`](https://perceptlayer.com/apis/idealista/location) | `country` `location_id` | 1 credit | | [GET `/v1/idealista/locations`](https://perceptlayer.com/apis/idealista/locations) | `country` `mode` +8 optional | 1 credit | | [GET `/v1/idealista/map-georeach`](https://perceptlayer.com/apis/idealista/map-georeach) | `country` `operation` `property_type` +24 optional | 1 credit | | [GET `/v1/idealista/map-multizone`](https://perceptlayer.com/apis/idealista/map-multizone) | `country` | 1 credit | | [GET `/v1/idealista/map-search`](https://perceptlayer.com/apis/idealista/map-search) | `country` `operation` `property_type` `mode` +24 optional | 1 credit | | [POST `/v1/idealista/map-simplify`](https://perceptlayer.com/apis/idealista/map-simplify) | `country` `shape` | 1 credit | | [GET `/v1/idealista/map-static`](https://perceptlayer.com/apis/idealista/map-static) | `country` `location_id` +1 optional | 1 credit | | [GET `/v1/idealista/map-tiles`](https://perceptlayer.com/apis/idealista/map-tiles) | `country` `operation` `property_type` `z` `x` `y` +24 optional | 1 credit | | [GET `/v1/idealista/map-zoi`](https://perceptlayer.com/apis/idealista/map-zoi) | `country` `slug` +1 optional | 1 credit | | [GET `/v1/idealista/news`](https://perceptlayer.com/apis/idealista/news) | `country` | 1 credit | | [GET `/v1/idealista/phones-prefixes`](https://perceptlayer.com/apis/idealista/phones-prefixes) | `country` `language` | 1 credit | | [GET `/v1/idealista/search`](https://perceptlayer.com/apis/idealista/search) | `country` `operation` `property_type` +24 optional | 1 credit | | [POST `/v1/idealista/shorturis`](https://perceptlayer.com/apis/idealista/shorturis) | `country` `direction` +5 optional | 1 credit | | [GET `/v1/idealista/vacation-calendar`](https://perceptlayer.com/apis/idealista/vacation-calendar) | `country` `ad_id` +4 optional | 1 credit | Overview ## About the Idealista API ## What you can get The Idealista API returns map search, search, agency and deeplink build as clean JSON. Each successful call costs one credit, and calls that fail are free. Real estate JSON REST MCP ### More real estate APIs [99acres](https://perceptlayer.com/apis/99acres) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Argenprop](https://perceptlayer.com/apis/argenprop) [Bayut](https://perceptlayer.com/apis/bayut) [Bien'ici](https://perceptlayer.com/apis/bienici) [Boliga](https://perceptlayer.com/apis/boliga) [Booli](https://perceptlayer.com/apis/booli) [Casa.it](https://perceptlayer.com/apis/casa-it) [Centris](https://perceptlayer.com/apis/centris) [Crexi](https://perceptlayer.com/apis/crexi) [Daft.ie](https://perceptlayer.com/apis/daft-ie) [Domain.com.au](https://perceptlayer.com/apis/domain-com-au) Use cases ### Monitor listing prices and new listings `Use the Idealista API to monitor listing prices and new listings` ### Pull comparables for valuations `Use the Idealista API to pull comparables for valuations` ### Power alerts and investment analysis `Use the Idealista API to power alerts and investment analysis` FAQ ## Questions **How much does the Idealista API cost?** Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a separate key for Idealista?** No. One key works for every API in the catalogue. ## Try the Idealista API with 1,000 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)