Unofficial REST API for Idealista listings

Search, filter and enrich real-estate listings from Idealista's catalog in Spain, Portugal and Italy. Plain JSON over HTTP — no scraper of your own to keep alive.

This is not an official Idealista product. apidea is an independent third-party wrapper, not affiliated with, endorsed by or sponsored by Idealista S.A.U. All property data belongs to Idealista and its original publishers.

Countries Spain, Portugal, Italy

Operations Sale and rent

Verticals Homes, new developments, offices, premises, garages, storage rooms, land, buildings

Also Listing detail, per-ad stats, location resolution

Try it

curl 'https://idealista-real-estate.p.rapidapi.com/v1/search?operation=sale&propertyType=homes&locationIds=%5B0-EU-ES-28%5D&maxItems=5' \
  -H 'x-rapidapi-key: YOUR_KEY' \
  -H 'x-rapidapi-host: idealista-real-estate.p.rapidapi.com'

The API is distributed through RapidAPI: keys, plans and billing are handled there.

View plans on RapidAPI →

Documentation — open, no key needed

Integration guide — a cookbook with runnable code: locations, rentals, new developments, adaptive filters, bulk ingestion, retries.
OpenAPI 3.1 spec — always in sync with the deployed API. Generate a typed client in any language.
llms.txt — the whole API as one plain-text file. Hand it to your coding agent and it integrates the API without further explanation.
Location segment maps — Spain and Italy: every location with its listing count for rent and sale, pre-computed for planning a nationwide ingest.

Contact

Integration questions, custom packages, higher limits, extra countries or a dedicated instance: contacto@apidea.es. A human reads every message.