Get Results
Retrieve scraped data from Idealista Listings Search Export
https://api.lobstr.io/v1/resultsRetrieve scraped data from your Idealista Listings Search Export runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
squidstringqueryrequiredHash of the squid to get results from
runstringqueryHash of a specific run (optional)
pageintegerqueryPage number (default: 1). Example: 1
Result Fields
Each result object contains the following fields:
urlstringDirect URL to the listing on Idealista. Example: https://www.idealista.com/en/inmueble/106993032/
titlestringTitle of the property listing on Idealista. Example: Flat / apartment for sale in Galleteras Nn, La Ribera-Ibarrekolanda, Bilbao
priceintListed price of the property. Example: 526000
currencystringISO 3-letter currency code of the listed price. Example: EUR
bedroomsintNumber of bedrooms in the property. Example: 2
areaintLiving surface area of the property in square metres. Example: 99
floorstringFloor level where the property is located. Example: 1st floor exterior with lift
descriptionstringFull description text provided by the seller or agency on Idealista. Example: A little piece of nature in the heart of Bilbao. Ubide Barri is the new development by Loiola, located in the most sought-after enclave of Zorrotzaurre Island: on the first line of the Deusto estuary, surrounded by parks and with the best connections to the city.
phonestringContact phone number for the listing. Example: +34843750610
main_imagestringURL of the property's main listing image on Idealista. Example: https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/00/63/2d/1326662095.jpg
has_parking_spacebooleanWhether the listing includes a garage or parking space. Example: true
parking_space_included_in_pricebooleanWhether the garage or parking space is included in the listed price. Example: true
parking_space_pricefloat | nullExtra price of the parking space when not included in the listed price. null if included or not applicable. Example: 15000
Detail Fields
The following fields are populated only when get_property_details: true is set. They require an additional page visit per listing.
year_builtint | nullYear of construction of the property. Example: 1985
orientationstring | nullOrientation of the property (e.g. north, south, east, west or combinations). Example: south, east
heatingstring | nullHeating type and energy source as displayed on the listing. Example: individual gas
conditionstring | nullInterior condition of the property (e.g. second hand/good condition, to renovate). Example: second hand/good condition
energy_certificatestring | nullEnergy certificate consumption rating letter (A–G). Example: C
energy_consumptionfloat | nullEnergy consumption in kWh/m² per year from the energy performance certificate. Example: 142.5
energy_emissions_ratingstring | nullEnergy certificate emissions rating letter (A–G). Example: D
energy_emissionsfloat | nullCO₂ emissions in kg CO₂/m² per year from the energy performance certificate. Example: 28.3
community_costsfloat | nullMonthly community / homeowner association costs in the listing currency. Example: 85.0
constructed_areaint | nullConstructed area in square metres. Example: 115
usable_areafloat | nullUsable interior area in square metres. Example: 99.0
plot_of_landint | nullPlot or land size in square metres (houses). Example: 300
furnishedstring | nullFurnishing status of the property (rental listings). Example: furnished
has_fitted_wardrobesboolean | nullWhether the property has fitted wardrobes. Example: true
chalet_typestring | nullHouse sub-type for chalets (e.g. independantHouse, semidetachedHouse, terracedHouse). Example: independantHouse
is_duplexboolean | nullWhether the property is a duplex. Example: false
is_top_floorboolean | nullWhether the property is on the top floor. Example: false
is_auctionboolean | nullWhether the property is sold at auction. Example: false
agency_is_a_bankboolean | nullWhether the advertiser is a bank (bank-owned property). Example: false
floors_numberint | nullNumber of floors of the building or house. Example: 6
property_characteristicsjson | nullFull raw characteristics of the listing grouped by section, as returned by Idealista's detail page. Example: {"Basics": {"Bedrooms": "2", "Floor": "3rd"}, ...}
detail_modification_datestring | nullLast modification date of the listing as returned by the detail page (UTC). Example: 2026-08-20T12:00:00Z
Response
{ "total_results": 1, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 1, "data": [ { "id": 38127, "object": "result", "squid": "YOUR_SQUID_HASH", "run": "RUN_HASH", "url": "https://www.idealista.com/en/inmueble/106993032/", "title": "Flat / apartment for sale in Galleteras Nn, La Ribera-Ibarrekolanda, Bilbao", "price": 526000, "currency": "EUR", "bedrooms": 2, "area": 99, "floor": "1st floor exterior with lift", "description": "A little piece of nature in the heart of Bilbao. Ubide Barri is the new development by Loiola, located in the most sought-after enclave of Zorrotzaurre Island: on the first line of the Deusto estuary, surrounded by parks and with the best connections to the city.", "phone": "+34843750610", "main_image": "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/00/63/2d/1326662095.jpg", "scraping_time": "2026-03-20T09:15:00.000Z", "functions": null, "native_id": 38127 } ], "next": null, "previous": null }