GET/v1/results

Get Results

Retrieve scraped Idealista property listings with details and contact information

Retrieve property listings scraped from Idealista search results. Each result contains property details including price, area, bedrooms, description, and contact phone number.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes

Result Fields

integer

Unique identifier for this result

Example: 77153

object

string

Object type, always "result"

Example: result

squid

string

Hash ID of the squid that produced this result

Example: cd75312523ed4ba88f71fc6c984823e2

run

string

Hash ID of the run during which this result was scraped

Example: 170fd6e6629f45b284bdeeee8fbb1c20

title

string

Property listing title

Example: Detached house in calle Jesus Maria Leizaola, Berango

price

number

Listing price in specified currency

Example: 1275000

currency

string

Currency symbol for the listing price

Example: \u20ac

area

number

Built area in square meters

Example: 440

bedrooms

integer

Number of bedrooms

Example: 5

floor

string

Floor level (if provided)

Example: 3rd

description

string

Short listing description

Example: IC2 Berango offers for sale EXCLUSIVELY...

phone

string

Contact phone number for the listing

Example: +34946980112

main_image

stringnull

URL of the primary listing image

Example: null

url

string

Direct URL to the listing page on Idealista

Example: https://www.idealista.com/en/inmueble/104990102/

scraping_time

string

ISO timestamp when the listing was fetched

Example: 2025-01-29T08:46:11.581Z

native_id

integer

Internal listing identifier

Example: 77153

functions

objectnull

Reserved for function-specific metadata

Example: null

Parameters

squidstring

Required

The squid hash ID to get results from

runstring

Optional

Filter results by specific run hash ID

pageinteger

Optional

Page number for pagination (default: 1)

page_sizeinteger

Optional

Number of results per page (default: 100, max: 1000)

Pro Tip

Filter results by price range or area in your application code, or apply filters on Idealista before creating tasks for pre-filtered results.

Note

Phone numbers are formatted with country codes. Spanish numbers typically start with +34.