The playground

Try any of 1042 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/booking/v1/hotels/search2 credits

Search hotels in a destination for given dates (25 hotels per call, with prices, review scores, photos, room configurations).

Working example

Parameters

queryoptional

Destination as free text — city, region or landmark. Provide query OR dest_id+dest_type.

dest_idoptional

Advanced: Booking destination ID (unambiguous — bypasses the free-text lookup). Pair with dest_type.

dest_typeoptional

Advanced: the destination's type as Booking labels it (city, region, district, landmark, airport, hotel).

checkinoptional

Check-in date (YYYY-MM-DD). Always pass real dates — prices and availability depend on them.

checkoutoptional

Check-out date (YYYY-MM-DD).

adultsoptional

Number of adult guests. (1–30)

roomsoptional

Number of rooms. (1–30)

currencyoptional

Price currency (ISO code: EUR, USD, GBP, TRY…).

request preview

curl -X POST https://api.reefapi.com/booking/v1/hotels/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"dest_id":"-755070","dest_type":"city","checkin":"2026-08-01","checkout":"2026-08-03"}'

Hit Send to run this endpoint live.