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 for given dates (25 hotels per call, with prices, review scores, photos, room configurations).

Parameter		Allowed / range	Description
query	optional	—	Destination as free text — city, region or landmark. Provide query OR dest_id+dest_type.
dest_id	optional	—	Advanced: Booking destination ID (unambiguous — bypasses the free-text lookup). Pair with dest_type.
dest_type	optional	—	Advanced: the destination's type as Booking labels it (city, region, district, landmark, airport, hotel).
checkin	optional	—	Check-in date (YYYY-MM-DD). Always pass real dates — prices and availability depend on them.
checkout	optional	—	Check-out date (YYYY-MM-DD).
adults = 2	optional	1–30	Number of adult guests.
rooms = 1	optional	1–30	Number of rooms.
currency = EUR	optional	—	Price currency (ISO code: EUR, USD, GBP, TRY…).

Try in playground →

post/booking/v1/hotels/detail3 credits

Full hotel record: summary, rating breakdown, facilities, room types, surroundings, FAQ.

Parameter		Allowed / range	Description
page_name	optional	—	The hotel's URL slug — booking.com/hotel/<country>/<page_name>.html (also returned by hotels/search items).
country_code	optional	—	The 2-letter country code in the hotel URL (booking.com/hotel/<country_code>/…).
hotel_url	optional	—	Full hotel URL (alternative to page_name+country_code).
hotel_id	optional	—	Advanced: Booking hotel ID (from hotels/search).
checkin	optional	—	Check-in date (YYYY-MM-DD). Always pass real dates — prices and availability depend on them.
checkout	optional	—	Check-out date (YYYY-MM-DD).
adults = 2	optional	1–30	Number of adult guests.
rooms = 1	optional	1–30	Number of rooms.
currency = EUR	optional	—	Price currency (ISO code: EUR, USD, GBP, TRY…).

Try in playground →

post/booking/v1/hotels/availability2 credits

Visible room blocks (room, occupancy, price, cancellation policy, meal plan) for a destination's top hotel on given dates.

Parameter		Allowed / range	Description
query	optional	—	Destination free text. Provide query OR dest_id+dest_type.
dest_id	optional	—	Advanced: Booking destination ID (unambiguous — bypasses the free-text lookup). Pair with dest_type.
dest_type	optional	—	Advanced: the destination's type as Booking labels it (city, region, district, landmark, airport, hotel).
checkin	optional	—	Check-in date (YYYY-MM-DD). Always pass real dates — prices and availability depend on them.
checkout	optional	—	Check-out date (YYYY-MM-DD).
hotel_id	optional	—	Pin to one hotel from the search results (default: the top result).
adults = 2	optional	1–30	Number of adult guests.
rooms = 1	optional	1–30	Number of rooms.
currency = EUR	optional	—	Price currency (ISO code: EUR, USD, GBP, TRY…).

Try in playground →

post/booking/v1/hotels/reviews1 credit

Paginated, deduped guest reviews for one hotel (score, title, pros/cons text, owner reply, room type, stay info).

Parameter		Allowed / range	Description
page_name	optional	—	The hotel's URL slug — booking.com/hotel/<country>/<page_name>.html (also returned by hotels/search items).
country_code	optional	—	The 2-letter country code in the hotel URL (booking.com/hotel/<country_code>/…).
hotel_url	optional	—	Full hotel URL (alternative to page_name+country_code).
max_reviews	optional	1–10000	How many reviews to fetch. Omit for ALL reviews (paged 25/page internally).
review_page_size = 25	optional	1–25	Advanced: reviews per internal page (Booking caps at 25).
hotel_id	optional	—	Advanced: Booking hotel ID.

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
}