Skip to content
Happy Endpoint
Idealista API
API Idealista

Idealista API

Live real estate data for Spain, Italy, and Portugal. Access detailed property listings, agent data, and market analytics.

Overview

The Idealista Data API allows developers to search properties, retrieve detailed listing information, analyze listing engagement, resolve property URLs, access agent intelligence, perform geo-based searches and build advanced real-estate applications using a clean and scalable interface.

Whether you’re building real-estate marketplaces, investment dashboards, relocation platforms, analytics systems, CRM integrations, lead generation tools, AI-powered housing applications, automation workflows, or map-based property experiences, this API provides reliable programmatic access to structured housing-market data across Spain, Italy, and Portugal.

What the API Covers

Advanced Property Search supports searching real-estate listings using flexible filters and structured search parameters, including city or region, price range, property type, bedrooms & bathrooms, rent or sale operation, keywords, and more.

AI-Powered Smart Search lets you use natural-language and intent-based property discovery to simplify complex searches.

Geo & ZIP-Based Search helps you search listings using ZIP codes, coordinates, and map-based location data.

Comprehensive Property Intelligence retrieves detailed property information with structured listing metadata. Responses may include full descriptions, images & media, pricing information, geolocation data, energy certifications, amenities & features, publication dates, floor plans, virtual tours, and agent information.

Listing Analytics & Engagement Data gives you access to listing engagement metrics and market-performance insights, such as visits, favorites, contacts, engagement metrics, listing activity, and user comments.

Agent & Agency Intelligence retrieves structured information about agencies, agents and active listings, including agency branding, active listings, contact details, microsite information, and portfolio insights.

Use Cases

  • Real Estate Aggregators: Build searchable property marketplaces with live listing data.
  • Investment & Market Analytics: Track pricing trends, analyze neighborhoods and identify opportunities.
  • CRM & Internal Tools: Sync property and agent information into internal workflows.
  • AI & Automation: Use structured real-estate data in LLMs, recommendation systems and automation pipelines.
  • Relocation & Housing Apps: Help users discover neighborhoods and homes using geo-search and autocomplete.
  • Geo & Map Applications: Build map-based property search experiences using coordinates and reverse geocoding.

Authentication

All requests require the standard RapidAPI headers:

  • X-RapidAPI-Key: your RapidAPI key
  • X-RapidAPI-Host: idealista17.p.rapidapi.com

Disclaimer: This API is an independent third-party service and is not affiliated with, endorsed by or sponsored by Idealista or Idealista S.A.U.

What you can do

Advanced Property Search
AI-Powered Smart Search
Geo & ZIP-Based Search
Comprehensive Property Intelligence
Listing Analytics & Engagement
Agent & Agency Intelligence

Endpoints & Schema

MethodPathSummary
GET/auto-completeLocation autocomplete by name prefix.
GET/smart-searchNatural-language search - server parses a free-text query into structured filter params.
GET/sublocationsDrill from a parent location to its direct children.
GET/reverse-geocodeFind points of interest closest to a latitude/longitude pair.
GET/property-searchPaginated property search by location.
GET/property-search-by-urlPaste any public Idealista search URL and get listings back in one call.
GET/property-search-by-coordinatesSearch listings inside a circular area defined by latitude, longitude, and radius.
GET/property-search-by-zipSearch listings by postal code.
GET/property-detailsFull property detail page (PDP).
GET/property-details-by-urlPaste any property URL and get the full property detail page back in one call.
GET/listing-statsView counts and lead-engagement stats for a listing.
GET/commentsListing description text for a property, auto-translated into the requested language.
GET/agent-detailsAgency / agent profile: branding, contact, phone, active listings.
GET/agent-listingsPaginated listings published by a specific agency.

Frequently asked questions

What does the Idealista API return?+
Live real estate data for Spain, Italy, and Portugal. Access detailed property listings, agent data, and market analytics.
How do I get an API key?+
Subscribe to this API on RapidAPI. You'll get keys, usage dashboards, and plan management out of the box.
Is there a free tier?+
Most APIs include a free tier for testing. Check the pricing tab on RapidAPI for the latest plan details.
Can I try the data before subscribing?+
Free samples are available for several platforms - see available samples.