The playground

Try any of 1404 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com

post/idealista/v1/search2 credits

Search Idealista property listings by location (Spain, Italy or Portugal; for sale or rent) with structured filters: price (EUR), bedrooms, surface (m²), property type and sort. Each result carries id, title, price, rooms, bathrooms, surface, floor, features and thumbnail. Paginate with page.

Working example

Parameters

locationrequired

countryoptional

contractoptional

sortoptional

home_typeoptional

pageoptional

price_minoptional

price_maxoptional

rooms_minoptional

surface_minoptional

request preview

curl -X POST https://api.reefapi.com/idealista/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location":"Madrid","country":"es"}'

Hit Send to run this endpoint live.