Search Spanish and international property listings on idealista using the official idealista Search API
domain: idealista.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Submit an API access request at developers.idealista.com, since keys are not issued via instant self-serve signup
Once approved, obtain client credentials and complete OAuth authentication against the idealista API token endpoint
Call the search endpoint (e.g. under https://api.idealista.com/3.5/) with location, property type, and price/area filters
Parse returned listings for price, address, geolocation, agency, and media fields
Respect the account's rate limit/quota tier and cache results rather than re-querying identical searches repeatedly
Known gotchas
Access requires an approved application through idealista's developer portal; there is no anonymous or trial key, and approval timelines vary by use case
API versioning is reflected in the URL path (e.g. /3.5/); scraping-based third-party 'idealista API' products are not the same as, and do not share guarantees with, the official API
Country/market coverage and available filters differ between idealista's home market (Spain) and its other operating countries (Italy, Portugal), so a filter valid in one market may be unsupported in another
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?