1 credit per call22 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 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"

cURL1 credit per successful call

Run this call below or from your dashboard to see a live response.

Playground

Run this API

cURLshell

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`	`countrymicrosite_short_name`	1 credit
POST`/v1/idealista/deeplink-build`	`countrylocation_id`+3 optional	1 credit
GET`/v1/idealista/deeplink-parse`	`countryurl`+1 optional	1 credit
GET`/v1/idealista/filters`	`countryoperationproperty_typelocation_id`+3 optional	1 credit
GET`/v1/idealista/home`	`country`+2 optional	1 credit
GET`/v1/idealista/listing`	`countryad_id`+9 optional	1 credit
GET`/v1/idealista/listing-multimedia`	`countryad_id`+2 optional	1 credit
GET`/v1/idealista/listing-stats`	`countryad_id`+1 optional	1 credit
GET`/v1/idealista/location`	`countrylocation_id`	1 credit
GET`/v1/idealista/locations`	`countrymode`+8 optional	1 credit
GET`/v1/idealista/map-georeach`	`countryoperationproperty_type`+24 optional	1 credit
GET`/v1/idealista/map-multizone`	`country`	1 credit
GET`/v1/idealista/map-search`	`countryoperationproperty_typemode`+24 optional	1 credit
POST`/v1/idealista/map-simplify`	`countryshape`	1 credit
GET`/v1/idealista/map-static`	`countrylocation_id`+1 optional	1 credit
GET`/v1/idealista/map-tiles`	`countryoperationproperty_typezxy`+24 optional	1 credit
GET`/v1/idealista/map-zoi`	`countryslug`+1 optional	1 credit
GET`/v1/idealista/news`	`country`	1 credit
GET`/v1/idealista/phones-prefixes`	`countrylanguage`	1 credit
GET`/v1/idealista/search`	`countryoperationproperty_type`+24 optional	1 credit
POST`/v1/idealista/shorturis`	`countrydirection`+5 optional	1 credit
GET`/v1/idealista/vacation-calendar`	`countryad_id`+4 optional	1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

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 Read the docs