Get full Idealista property data.
Send a property ID and receive structured data on pricing, features, and descriptions. No scraper maintenance or proxy rotation required.
How it works
One request, one response.
- 1
Submit property ID
Send the unique listing identifier along with the specific country code in a JSON body.
- 2
Extract listing data
The system retrieves the latest pricing, metadata, and features directly from the live listing.
- 3
Receive structured JSON
Get a clean response containing room counts, energy ratings, status updates, and property descriptions.
Capabilities
What you get.
Everything this endpoint does, without running the infrastructure yourself.
Multi-region support
Access property records across Spain, Portugal, and Italy using the same unified request structure.
Localized descriptions
Request property text in nine supported languages to suit international real estate applications.
Detailed metadata
Extract specific attributes such as elevator availability, heating systems, and construction year.
Pricing snapshots
Retrieve current asking prices and historical price changes as they appear on the platform.
Cost of ownership
Build it yourself, or call this.
Both are real options. Here is what each one actually costs you.
Run it yourself
- Manage residential proxy rotations
- Build custom parsers for three regional domains
- Handle frequent anti-bot changes
- Maintain server infrastructure for headless browsers
Call the API
- Single POST request for any listing
- Structured JSON ready for database ingestion
- Automatic regional domain handling
- Fixed credit cost per successful response
Integrate
Built for the language you use.
One HTTP endpoint. Copy the call in your language and go.
curl -X POST https://automatio.ai/api/v1/query \
-H "Authorization: Bearer $AUTOMATIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "tool": "idealista_details", "params": { "propertyId": "example", "location": "example" } }'In production
What people build with it.
Automated Appraisal Tools
Input a property ID to pull current listing features for instant valuation models. This allows developers to build tools that provide market estimates for buyers or sellers by comparing real-time data against historical records. It eliminates manual entry of property specifications.
Investment Portfolio Tracking
Monitor a list of specific properties to detect price drops or status changes. Investors can use the structured output to update ROI spreadsheets or internal dashboards automatically whenever the listing is modified. This ensures portfolio data remains accurate without manual checking.
International Real Estate Portals
Sync listings from Mediterranean markets into a global platform. By utilizing the language parameter, developers can ingest localized descriptions that match their user base. This streamlines the content translation process for cross-border property transactions.
Choosing parameters
Which options matter.
The table below lists what exists. These are the calls worth making deliberately.
- propertyId
- location
- language
Alternatives
When to use something else.
A page that pretends it has no alternatives reads as an advert. These are the other real options.
Official Idealista API
Requires a formal business partnership and commercial contract, making it better for professional listing management rather than simple data ingestion.
Custom Headless Script
Offers maximum control over data points but requires significant engineering time to maintain against Idealista's aggressive bot protection.
Before you integrate
What it does not do.
The boundaries are as useful as the features. These are the ones worth knowing up front.
Public data only
The API can only retrieve information visible on the public listing page. It cannot access hidden seller contact details or exact geographic coordinates that are protected by the host site.
Region locking
You cannot query a Spanish property ID using the Italy or Portugal location parameters. You must identify the correct regional source before making the call.
Attribute variance
Metadata fields like Energy Certificate levels or specific tax information may vary between countries. Your integration should handle null values for optional fields that do not exist in all regions.
Reference
135 credits per call- Endpoint
- POST https://automatio.ai/api/v1/query
- Tool ID
- idealista_details
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| propertyId | string | Property code from search results (e.g. "106387165") | |
| location | "es" | "pt" | "it" | Country code: Spain (es), Portugal (pt), Italy (it) | |
| language | "en" | "es" | "it" | "pt" | "ca" | "de" | "fr" | "nl" | "nb" | — | Response language (default: en) |
The same endpoints are available over MCP, and the full machine-readable catalogue lives in the API documentation.
Frequently Asked Questions
Find answers to common questions about Property Details API
Same data source
Every Real estate endpoint.
One key, one endpoint shape. These all bill per successful call the same way.
Property Locations API
Retrieve structured geographic metadata for Idealista location IDs across Spain, Italy, and Portugal. Get accurate regional data for real estate integrations.
135 creditsAgency Listings API
Extract property listings for real estate agencies on Idealista. Get structured data for sales or rentals in Spain, Italy, and Portugal via JSON.
135 creditsReal Estate Agency API
Extract structured real estate agency data from Idealista using the microsite ID. Access contact details, portfolio size, and metadata for Spain, Italy, and...
135 creditsIdealista Property Search API
Search real estate listings across Spain, Italy, and Portugal. Filter by location, price, and features like pools or terraces to get structured property data.
135 creditsLocation Autocomplete API
Access real-time location suggestions from Idealista for Spain, Italy, and Portugal. Convert partial text strings into valid geographic identifiers for search.
135 creditsOther endpoints
Browse all APIs →Supercharge your workflow with AI Automation
Automatio combines the power of AI agents, web automation, and smart integrations to help you accomplish more in less time.