Hotel Rooms API

Top-level fields

• success — boolean, always true for 2xx responses.
• data.hotel_info — basic property info (id, currency_code).
• data.rooms — array of room types with static data (see below).
• data.rates — array of bookable blocks for the requested dates (see below).
• data.availability_summary — deduplicated inventory totals across data.rates:
  • availability_status — available when at least one bookable rate was returned, otherwise no_inventory.
  • total_available_rooms — sum of the maximum room_count_available per room_id, so a room type sold under several rate plans is counted once. null when there are no bookable rates.
  • available_rate_blocks — number of entries in data.rates.
  • available_room_types_counted — number of distinct room_ids that contributed a count.
  • room_counts_by_room_id — the per-room-type counts that were summed.
  • rates_without_room_count_available — rate blocks returned without a usable count.
  • calculation_method — human-readable formula string.
• data.search_config — echoes the guest/date configuration you requested.
• data.metadata — hotel_id, total_rooms, total_blocks, arrival_date, departure_date, scraped_at.
• retrieved_at — ISO-8601 UTC timestamp.

Per-room fields (data.rooms[])

• id — stable room-type identifier.
• name — human-readable room-type name (derived from the first associated rate).
• description — full room description (may contain HTML formatting).
• ai_description — short AI-generated comparative description (may contain <b> tags).
• room_size_m2, room_size_ft2 — room size in metric and imperial units.
• is_smoking, is_dormitory — booleans.
• bathroom_count — number of bathrooms; null when Booking.com doesn't list a count (common for hotel rooms). private_bathroom — true for a private bathroom, false for a shared one, null when unknown.
• photos[] — array with id, url_original, url_max300, url_square60, url_640x200, and ratio.
• bed_configurations[] — each has a beds array with bed_type, name, name_with_count, count, description, description_imperial.
• facilities[] — each has id, name, category, category_id.
• highlights[] — each has id, name, icon.

Per-rate fields (data.rates[])

Each entry represents one bookable "block" — a specific combination of a room type, a cancellation/refund policy, and a meal plan. A single room type can appear multiple times (for example, refundable vs non-refundable).

• block_id — unique identifier for this bookable option.
• room_id — links this rate to an entry in data.rooms[].
• name — full rate name, e.g. "Laguna Twin Room - Non-refundable".
• room_name — the room-type name without the policy suffix.
• max_occupancy, nr_adults, nr_children.
• refundable, refundable_until — cancellation policy.
• breakfast_included, half_board, full_board, all_inclusive, mealplan — meal configuration.
• room_count_available — how many rooms of this type Booking.com will sell for the requested dates. It is bounded by the property’s allotment on Booking.com, not its physical inventory, and is typically identical across rate blocks sharing the same room_id, so do not sum it across rate blocks. Use data.availability_summary.total_available_rooms for a deduplicated total, and compare values only within one property across dates.
• genius_discount_percentage — Booking.com Genius loyalty discount if applicable.
• price — object with total, per_night, currency, formatted, plus before_discount (Booking.com's struck-through price, e.g. "$642") and discount_name (e.g. "Bonus savings") when the property offers a discount, otherwise null. Booking.com occasionally returns a rate without the discount, so a higher price with a null before_discount is an undiscounted quote.