Skip to main content
POST
/idealista/properties/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
location
string
required
Minimum string length: 1
count
integer
required
Required range: 1 <= x <= 1800
timeout
integer
default:300
Required range: 20 <= x <= 1500
domain
enum<string>
default:pt
Available options:
pt,
it
zone
string | null
operation
enum<string>
default:buy
Available options:
buy,
rent
property_type
enum<string>
default:homes
Available options:
homes,
land,
garages,
offices,
buildings,
storage_rooms,
commercial,
new_developments,
rooms
home_types
enum<string>[] | null
Available options:
pt_apartamentos,
pt_apenas_apartamentos,
pt_moradias,
pt_moradias_em_banda,
pt_moradias_geminadas,
pt_moradias_independentes,
pt_moradias_terreas,
pt_duplex,
pt_lofts,
pt_aguas_furtadas,
pt_casas_rusticas,
pt_quintas,
pt_solares_ou_palacetes,
it_appartamenti,
it_solo_appartamenti,
it_attici,
it_loft_open_space,
it_mansarde,
it_case_indipendenti,
it_ville,
it_ville_indipendenti,
it_villette_a_schiera,
it_rustici,
it_casali_o_cascine,
it_appartamenti_due_livelli
rooms
enum<string>[] | null
Available options:
pt_t0,
pt_t1,
pt_t2,
pt_t3,
pt_t4_or_more,
it_monolocale,
it_bilocale,
it_trilocale,
it_quadrilocale,
it_5_locali_or_more
bathrooms
enum<string>[] | null
Available options:
one,
two,
three_or_more
condition
enum<string>[] | null
Available options:
new_construction,
good,
to_renovate
energy_rating
enum<string>[] | null
Available options:
high,
medium,
low
floor
enum<string>[] | null
Available options:
top,
intermediate,
ground
features
enum<string>[] | null
Available options:
elevator,
pool,
garden,
private_garden,
terrace,
balcony,
terrace_or_balcony,
parking,
storage_room,
air_conditioning,
built_in_wardrobes,
accessible,
luxury,
sea_view,
floor_plan,
virtual_tour,
bank_owned,
tenanted,
judicial_auction,
pets_allowed,
furnished
min_price
integer | null
Required range: x >= 0
max_price
integer | null
Required range: x >= 0
min_size
integer | null
Required range: x >= 0
max_size
integer | null
Required range: x >= 0
sort
enum<string>
default:relevance
Available options:
relevance,
price_asc,
price_desc,
newest,
oldest,
price_drop,
price_per_m2_asc,
price_per_m2_desc,
size_asc,
size_desc,
floor_asc,
floor_desc

Response

Successful Response

id
string
required
@type
string
default:IdealistaPropertyCard
url
string | null
listing_title
string | null
price
number | null
previous_price
number | null
price_drop_percent
integer | null
price_per_m2
number | null
surface
integer | null
room_count
integer | null
photo_count
integer | null
floor
string | null
has_elevator
boolean | null
has_parking
boolean | null
is_professional
boolean | null
highlight
string | null
tags
string[]
features
string[]
images
string[]
agency
object | null