docs / booking

Booking.com

Search hotels with prices, scores and availability.

base /booking/v14 endpoints

post/booking/v1/hotels/search2 credits

search hotels in a destination (25/page)

Parameter	Required
query	optional
dest_id	optional
dest_type	optional
checkin	optional
checkout	optional

Try in playground →

post/booking/v1/hotels/detail3 credits

full hotel (rooms/facilities/surroundings/faq)

Parameter	Required
page_name	optional
country_code	optional
hotel_id	optional
hotel_url	optional
checkin	optional
checkout	optional

Try in playground →

post/booking/v1/hotels/availability2 credits

visible room blocks for dates

Parameter	Required
query	optional
dest_id	optional
checkin	optional
checkout	optional

Try in playground →

post/booking/v1/hotels/reviews1 credit

paginated guest reviews (deduped)

Parameter	Required
page_name	optional
country_code	optional
hotel_id	optional
max_reviews	optional

Try in playground →

Example request · hotels/search

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"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}