booking_search
Search for hotels and properties on Booking.com with optional amenity filters (pets, parking, pool) to find matching accommodations with ratings, prices, and availability.
Instructions
Search for hotels and properties on Booking.com. Returns property names, ratings, prices, and availability indicators. Optionally filter server-side by amenities/facilities (e.g. pets, parking, pool) so only matching properties are returned.\n\nPRICE FIELDS: pricePerNight and totalPrice both carry the same numeric value extracted from the card. On multi-night searches this is typically the TOTAL stay price (not per-night). Check priceIsTotal (true = total, false = explicitly per-night) and priceNote (raw card text) for context. currency is auto-detected from the card text when visible (e.g. 'CHF', 'EUR', 'USD'). For accurate per-night pricing on multi-night stays, divide totalPrice by number of nights.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rooms | No | Number of rooms (default: 1) | |
| adults | No | Number of adults (default: 2) | |
| checkIn | Yes | Check-in date in YYYY-MM-DD format | |
| rawNflt | No | Advanced/escape hatch: raw Booking.com `nflt` filter chips, ';'-delimited (e.g. 'hotelfacility=4;popular_activities=2'). Merged with `amenities`. Use when an amenity code needs correcting or for filters not in the amenities list. | |
| checkOut | Yes | Check-out date in YYYY-MM-DD format | |
| children | No | Number of children (default: 0) | |
| amenities | No | Filter results server-side to properties offering ALL of these amenities/facilities. Supported: pets, parking, pool, restaurant, room_service, front_desk_24h, fitness, non_smoking, airport_shuttle, family_rooms, ev_charging, spa, hot_tub, sauna, free_wifi, air_conditioning. Example: ["pets", "parking", "pool"] for pet-friendly hotels with parking and a pool. | |
| maxResults | No | Maximum results to return (default: 10, max: 50) | |
| destination | Yes | Destination to search (e.g. 'Paris', 'New York', 'Rome, Italy') | |
| flex_window | No | Date flexibility window (days). 0 = exact dates only (default). Positive values search with flexible dates around the given checkIn/checkOut: 1=±1 day, 2=±2 days, 3=±3 days, 7=±7 days. When >0, Booking.com returns properties available across the date window, which can reveal cheaper options just outside your exact dates. |