Sign inGet a free API key
Menu

APIs / Real estate / Idealista

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 keySee all 22 endpoints
22endpoints
1credit per successful call
JSONevery response
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 from your dashboard to see a live response.

Idealista · 22 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointWhat it returnsCost
GET/v1/idealista/agencyAgency 1 credit
POST/v1/idealista/deeplink-buildDeeplink Build 1 credit
GET/v1/idealista/deeplink-parseDeeplink Parse 1 credit
GET/v1/idealista/filtersFilters 1 credit
GET/v1/idealista/homeHome 1 credit
GET/v1/idealista/listingListing 1 credit
GET/v1/idealista/listing-multimediaListing Multimedia 1 credit
GET/v1/idealista/listing-statsListing Stats 1 credit
GET/v1/idealista/locationLocation 1 credit
GET/v1/idealista/locationsLocations 1 credit
GET/v1/idealista/map-georeachMap Georeach 1 credit
GET/v1/idealista/map-multizoneMap Multizone 1 credit
GET/v1/idealista/map-searchMap Search 1 credit
POST/v1/idealista/map-simplifyMap Simplify 1 credit
GET/v1/idealista/map-staticMap Static 1 credit
GET/v1/idealista/map-tilesMap Tiles 1 credit
GET/v1/idealista/map-zoiMap Zoi 1 credit
GET/v1/idealista/newsNews 1 credit
GET/v1/idealista/phones-prefixesPhones Prefixes 1 credit
GET/v1/idealista/searchSearch 1 credit
POST/v1/idealista/shorturisShorturis 1 credit
GET/v1/idealista/vacation-calendarVacation Calendar 1 credit

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.

Use cases

  • Monitor listing prices and new listings
  • Pull comparables for valuations
  • Power alerts and investment analysis

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.

Related

99acresApartments.comArgenpropBayutBien'iciBoligaBooliCasa.itCentrisCrexiDaft.ieDomain.com.au

Try the Idealista API with 1,000 free credits

No card and no password. We email you a sign-in link, and your key works on every API.

Get a free API keyRead the docs

No credit card. 1,000 free credits a month.