Scrappa is an independent Idealista API for property search, listing details, photos and tours, engagement stats, agency profiles, locations, and map data across Spain, Italy, Portugal, and France. Pick the market with one country parameter and get structured JSON for sale and rental listings without maintaining your own Idealista scraper. Scrappa is not affiliated with or endorsed by Idealista.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/idealista/search?country=es&operation=sale&property_type=homes&location_id=0-EU-ES-28&max_items=2" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"{
"success": true,
"data": {
"elementList": [
{
"propertyCode": "104570830",
"price": 990000,
"priceInfo": {
"price": {
"amount": 990000,
"currencySuffix": "€",
"priceDropInfo": {
"formerPrice": 1190000,
"priceDropValue": 200000,
"priceDropPercentage": 17
}
}
},
"propertyType": "penthouse",
"operation": "sale",
"size": 102,
"rooms": 2,
"bathrooms": 2,
"floor": "7",
"address": "Ático en Calle de Alcalá, Guindalera, Madrid",
"district": "Barrio de Salamanca",
"neighborhood": "Guindalera",
"locationId": "0-EU-ES-28-07-001-079-04-004",
"latitude": 40.4288816,
"longitude": -3.6647074,
"url": "https://www.idealista.com/inmueble/104570830/"
}
],
"total": 32703,
"totalPages": 16352,
"actualPage": 1,
"itemsPerPage": 2
},
"meta": {
"duration_ms": 1048,
"endpoint_family": "search"
}
}Structured data for real applications. Here are some ideas.
Track asking prices and price drops for a city or neighborhood. Search results include the current price plus former price, drop value, and drop percentage when a listing has been reduced.
Build comparables for valuations from size, rooms, bathrooms, floor, energy certificate, and location fields on Idealista listings in Spain, Italy, Portugal, and France.
Monitor an agency's profile and active stock over time by combining the agency endpoint with searches filtered by the same microsite short name.
Feed listing photos, videos, 3D tours, and virtual staging into a property portal or CRM with tagged images and media dimensions.
Measure listing demand with views, favorites, email contacts, and shares per listing from the listing stats endpoint.
Plot listings, price pins, zone polygons, location boundaries, and rendered map tiles in your own map UI, and search inside a drawn polygon.
Idealista scraper API
The Idealista API is built for proptech teams, investors, analysts, and agencies who need Idealista data in their own tools. Search sale and rental stock by location, radius, agency, or drawn area, then pull the full listing with price, size, rooms, floor, energy rating, coordinates, agency contact block, photos, videos, 3D tours, and engagement stats. Every successful response uses the same envelope with success, data, and meta, and one country parameter switches between Spain, Italy, Portugal, and France.
Query four markets: Spain (es), Italy (it), Portugal (pt), and France (fr).
Search twelve property types for sale or rent, including homes, new developments, rooms, offices, retail premises, garages, land, luxury, and vacation rentals.
Filter by price, size, rooms, occupancy status, and, in Italy, auctions, and page through results with num_page.
Get listing detail with price and price drops, size, rooms, floor, energy certificate, coordinates, administrative areas, agency block, and translated descriptions.
Pull photos, videos, 3D tours, and virtual staging, plus views, favorites, email contacts, and shares per listing.
Use map helpers for zone polygons, PNG map tiles, static map URLs, polygon simplification, and conversion between Idealista web links and API filters.
Test the Idealista API with 500 free monthly Scrappa credits before scaling production traffic.
Resolve a location id with the locations endpoint, then search by location_id, a center point with distance, an agency microsite_short_name, or a GeoJSON shape. Results include propertyCode, price and price drop info, property type, size, rooms, bathrooms, floor, address, district, neighborhood, coordinates, and the listing URL.
Open Idealista Search API docsPass a propertyCode as ad_id to get the full listing with characteristics, location, contact info, descriptions, energy certification, and multimedia. Add include=stats, comment, multimedia, or recommendation to merge extra data into the same response.
Open Idealista Listing API docsPaste an Idealista search URL into the deeplink parse endpoint to get operation, property type, location id, and feature flags, then reuse those filters in search. Build the matching web URL again with the deeplink build endpoint.
Open Idealista Parse Search URL docsEverything you need in one API.
/api/idealista/search
Search sale and rental listings by location, radius, agency, or polygon with price, size, and room filters
/api/idealista/locations
Find location ids from text, coordinates, or vacation destinations
/api/idealista/location
Get the GeoJSON boundary of a location id
/api/idealista/shorturis
Convert location ids to Idealista short URIs and back
/api/idealista/filters
Get the filter schema and shortcut tabs for a search
/api/idealista/listing
Get full listing detail, optionally with media, comments, stats, and similar ads
/api/idealista/listing/multimedia
Get photos, videos, 3D tours, and virtual staging for a listing
/api/idealista/listing/stats
Get views, favorites, email contacts, and shares for a listing
/api/idealista/map/search
Run a search for map display, as listings or as price pins
/api/idealista/map/tiles
Get a rendered map tile for a search as a base64 PNG
/api/idealista/map/zoi
Get the polygon of a named Idealista zone of interest
/api/idealista/map/static
Get a static map image URL outlining a location
/api/idealista/map/georeach
Run a geo reach search, typically for new developments
/api/idealista/map/multizone
Get the multizone map configuration, minimaps, and zone tree
/api/idealista/map/simplify
Simplify a GeoJSON polygon for use as a search shape
/api/idealista/agency
Get an agency profile by its microsite short name
/api/idealista/deeplink/parse
Turn an Idealista search URL into search filters
/api/idealista/deeplink/build
Turn a location and filters into an Idealista web URL
/api/idealista/vacation/calendar
Get unavailable dates and optional pricing for a vacation rental
/api/idealista/phones/prefixes
Get international phone prefixes with localized country names
/api/idealista/home
Get the featured home page picture and listing for a market
/api/idealista/news
Get the latest Idealista news for a market
Add German property search, details, and price insights from ImmobilienScout24 to your European real estate coverage.
Compare European Idealista data with US listings, property details, and home valuation estimates from Redfin.
Pair Idealista vacation rental data with Booking.com hotel search cards, visible prices, and review score fields.
See how Scrappa compares to the official API.
| Feature | Scrappa | Generic scraping APIs |
|---|---|---|
| Dedicated Idealista endpoints | Yes (22 endpoints) | |
| Output format | Structured JSON | Raw HTML |
| Spain, Italy, Portugal, and France | One country parameter | Separate scrapers |
| Listing stats and media | You write the parser | |
| Map tiles and zone polygons | ||
| Parser maintenance | Handled by Scrappa | Your team |
| Price per 1k requests | From $0.20 | Varies by plan and credit multiplier |
| Free tier | 500 credits/month | Varies by provider |
The Idealista API is Scrappa's REST API for Idealista property data. It covers property search, full listing details, photos and tours, listing engagement stats, agency profiles, location lookups, and map data for Spain, Italy, Portugal, and France as structured JSON.
No. Scrappa is an independent service and is not affiliated with or endorsed by Idealista. You only need a Scrappa API key to use the 22 endpoints on this page.
Call the locations endpoint with mode=suggest and a prefix such as Barcelona, then use the locationId of the best match. You can also paste an Idealista search URL into the deeplink parse endpoint, or reuse locationId values from search results.
Search returns up to 5 results per page with max_items, which defaults to 2. Request further pages with num_page and stop when actualPage equals totalPages or paginable is false. Each page is one request.
Yes. Find the agency micrositeShortName in a listing's contactInfo, then call search with microsite_short_name. Use the agency endpoint for the profile itself, including active listing count, website, languages, and branding images.
No. Image URLs are signed and expire. Store the listing id and request fresh media from the listing multimedia endpoint when you need to display it.
Yes. Every Scrappa account includes 500 free credits per month, so you can test the Idealista endpoints before buying credit packs or moving to a subscription.
Each request uses one Scrappa credit, and paid usage starts at $0.20 per 1,000 requests. Failed requests are not billed.