Skip to content
Examples

Get Results

Retrieve scraped data from Idealista Listings Search Export

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Idealista Listings Search Export runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

urlstring

Direct URL to the listing on Idealista. Example: https://www.idealista.com/en/inmueble/106993032/

titlestring

Title of the property listing on Idealista. Example: Flat / apartment for sale in Galleteras Nn, La Ribera-Ibarrekolanda, Bilbao

priceint

Listed price of the property. Example: 526000

currencystring

ISO 3-letter currency code of the listed price. Example: EUR

bedroomsint

Number of bedrooms in the property. Example: 2

areaint

Living surface area of the property in square metres. Example: 99

floorstring

Floor level where the property is located. Example: 1st floor exterior with lift

descriptionstring

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.

phonestring

Contact phone number for the listing. Example: +34843750610

main_imagestring

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

has_parking_spaceboolean

Whether the listing includes a garage or parking space. Example: true

parking_space_included_in_priceboolean

Whether the garage or parking space is included in the listed price. Example: true

parking_space_pricefloat | 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.

year_builtint | null

Year of construction of the property. Example: 1985

orientationstring | null

Orientation of the property (e.g. north, south, east, west or combinations). Example: south, east

heatingstring | null

Heating type and energy source as displayed on the listing. Example: individual gas

conditionstring | null

Interior condition of the property (e.g. second hand/good condition, to renovate). Example: second hand/good condition

energy_certificatestring | null

Energy certificate consumption rating letter (A–G). Example: C

energy_consumptionfloat | null

Energy consumption in kWh/m² per year from the energy performance certificate. Example: 142.5

energy_emissions_ratingstring | null

Energy certificate emissions rating letter (A–G). Example: D

energy_emissionsfloat | null

CO₂ emissions in kg CO₂/m² per year from the energy performance certificate. Example: 28.3

community_costsfloat | null

Monthly community / homeowner association costs in the listing currency. Example: 85.0

constructed_areaint | null

Constructed area in square metres. Example: 115

usable_areafloat | null

Usable interior area in square metres. Example: 99.0

plot_of_landint | null

Plot or land size in square metres (houses). Example: 300

furnishedstring | null

Furnishing status of the property (rental listings). Example: furnished

has_fitted_wardrobesboolean | null

Whether the property has fitted wardrobes. Example: true

chalet_typestring | null

House sub-type for chalets (e.g. independantHouse, semidetachedHouse, terracedHouse). Example: independantHouse

is_duplexboolean | null

Whether the property is a duplex. Example: false

is_top_floorboolean | null

Whether the property is on the top floor. Example: false

is_auctionboolean | null

Whether the property is sold at auction. Example: false

agency_is_a_bankboolean | null

Whether the advertiser is a bank (bank-owned property). Example: false

floors_numberint | null

Number of floors of the building or house. Example: 6

property_characteristicsjson | null

Full raw characteristics of the listing grouped by section, as returned by Idealista's detail page. Example: {"Basics": {"Bedrooms": "2", "Floor": "3rd"}, ...}

detail_modification_datestring | null

Last modification date of the listing as returned by the detail page (UTC). Example: 2026-08-20T12:00:00Z

Response

200
{
  "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
}