Skip to main content
GET
Get Results
Retrieve scraped data from your Idealista Listings Search Export runs.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

string
required
Hash of the squid to get results from
string
Hash of a specific run (optional)
integer
Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:
string
Direct URL to the listing on Idealista. Example: https://www.idealista.com/en/inmueble/106993032/
string
Title of the property listing on Idealista. Example: Flat / apartment for sale in Galleteras Nn, La Ribera-Ibarrekolanda, Bilbao
int
Listed price of the property. Example: 526000
string
ISO 3-letter currency code of the listed price. Example: EUR
int
Number of bedrooms in the property. Example: 2
int
Living surface area of the property in square metres. Example: 99
string
Floor level where the property is located. Example: 1st floor exterior with lift
string
Full 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.
string
Contact phone number for the listing. Example: +34843750610
string
URL 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
boolean
Whether the listing includes a garage or parking space. Example: true
boolean
Whether the garage or parking space is included in the listed price. Example: true
float | null
Extra 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.
int | null
Year of construction of the property. Example: 1985
string | null
Orientation of the property (e.g. north, south, east, west or combinations). Example: south, east
string | null
Heating type and energy source as displayed on the listing. Example: individual gas
string | null
Interior condition of the property (e.g. second hand/good condition, to renovate). Example: second hand/good condition
string | null
Energy certificate consumption rating letter (A–G). Example: C
float | null
Energy consumption in kWh/m² per year from the energy performance certificate. Example: 142.5
string | null
Energy certificate emissions rating letter (A–G). Example: D
float | null
CO₂ emissions in kg CO₂/m² per year from the energy performance certificate. Example: 28.3
float | null
Monthly community / homeowner association costs in the listing currency. Example: 85.0
int | null
Constructed area in square metres. Example: 115
float | null
Usable interior area in square metres. Example: 99.0
int | null
Plot or land size in square metres (houses). Example: 300
string | null
Furnishing status of the property (rental listings). Example: furnished
boolean | null
Whether the property has fitted wardrobes. Example: true
string | null
House sub-type for chalets (e.g. independantHouse, semidetachedHouse, terracedHouse). Example: independantHouse
boolean | null
Whether the property is a duplex. Example: false
boolean | null
Whether the property is on the top floor. Example: false
boolean | null
Whether the property is sold at auction. Example: false
boolean | null
Whether the advertiser is a bank (bank-owned property). Example: false
int | null
Number of floors of the building or house. Example: 6
json | null
Full raw characteristics of the listing grouped by section, as returned by Idealista’s detail page. Example: {"Basics": {"Bedrooms": "2", "Floor": "3rd"}, ...}
string | null
Last modification date of the listing as returned by the detail page (UTC). Example: 2026-08-20T12:00:00Z

Response

200