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