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/geography0 credits

Resolve a free-text place name to the Idealista location slug + a ready-to-use search preview (the count of active listings there). Use it to confirm a location before searching, or to discover the exact slug a city resolves to.

Working example

Parameters

queryrequired

countryoptional

contractoptional

request preview

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

Hit Send to run this endpoint live.