Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "url": "<string>",
  "title": "<string>",
  "price": 123,
  "currency": "<string>",
  "bedrooms": 123,
  "area": 123,
  "floor": "<string>",
  "description": "<string>",
  "phone": "<string>",
  "main_image": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve scraped data from your Idealista Listings Search Export runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

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

​
Result Fields

Each result object contains the following fields:
​
url
string
Direct URL to the listing on Idealista. Example: https://www.idealista.com/en/inmueble/106993032/
​
title
string
Title of the property listing on Idealista. Example: Flat / apartment for sale in Galleteras Nn, La Ribera-Ibarrekolanda, Bilbao
​
price
int
Listed price of the property. Example: 526000
​
currency
string
ISO 3-letter currency code of the listed price. Example: EUR
​
bedrooms
int
Number of bedrooms in the property. Example: 2
​
area
int
Living surface area of the property in square metres. Example: 99
​
floor
string
Floor level where the property is located. Example: 1st floor exterior with lift
​
description
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.
​
phone
string
Contact phone number for the listing. Example: +34843750610
​
main_image
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