Idealista
get/idealista/search
Request
- Base URL: https://scrappa.co/api
- URL: https://scrappa.co/api/idealista/search
- Auth: API key in header X-API-KEY
Query parameters
country'es' | 'it' | 'pt' | 'fr' required
Market: es, it, pt, or fr. Default es.
operation'sale' | 'rent' required
sale or rent. Room stock uses bedrooms + rent.
property_type'homes' | 'newDevelopments' | 'bedrooms' | 'offices' | 'premises' | 'transfers' | 'buildings' | 'storageRooms' | 'garages' | 'vacationRentals' | 'luxury' | 'lands' required
homes, newDevelopments, bedrooms, offices, premises, transfers, buildings, storageRooms, garages, vacationRentals, luxury, or lands.
location_idstring nullable
Idealista location id such as 0-EU-ES-28.
centerstring nullable
lat,lon for near-me search.
distanceinteger nullable
Radius in meters when using center.
max_itemsinteger
Page size honored by origin, 1-5.
num_pageinteger
1-based page number.
orderstring nullable
sort'asc' | 'desc' | 'null' nullable
quality'high' | 'low' | 'null' nullable
galleryboolean nullable
localestring nullable
microsite_short_namestring nullable
Anonymous agency stock filter, for example clikalia.
chaletboolean nullable
Apply-filter key. Send true on homes.
current_occupation_type'free' | 'bareOwnership' | 'tenanted' | 'illegallyOccupied' | 'viager' | 'null' nullable
free, bareOwnership, tenanted, illegallyOccupied, or viager.
auction'onlyAuctions' | 'excludeAuctions' | 'null' nullable
IT only: onlyAuctions or excludeAuctions.
home_typestring nullable
bank_offerstring nullable
advertiser_typestring nullable
min_priceinteger nullable
max_priceinteger nullable
min_sizeinteger nullable
max_sizeinteger nullable
min_roomsinteger nullable
max_roomsinteger nullable
shapestring nullable
Response
string required
Changes
No recorded changes to this operation across all 4 revisions of this API.