The Booking Hotel Search endpoint queries Booking.com in real time and returns structured hotel listings for a given destination. Each result includes the property name, type, description, star rating, guest review score, pricing per night, room availability, address, geolocation, and more, all ready for integration.
GET https://api.piloterr.com/v2/booking/hotel/search?query=Paris&check_in=2026-06-15&check_out=2026-06-18&adults=2¤cy=EUR
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Destination name, city, or region |
check_in |
string |
no |
Check-in date in YYYY-MM-DD format |
check_out |
string |
no |
Check-out date in YYYY-MM-DD format |
adults |
integer |
no |
Number of adult guests (default 2, max 50) |
rooms |
integer |
no |
Number of rooms (default 1, max 50) |
children |
integer |
no |
Number of children (default 0, max 50) |
currency |
string |
no |
ISO 4217 currency code (default USD) |
language |
string |
no |
Language code for response content (default en-gb) |
min_score |
string |
no |
Minimum guest rating score (e.g. 8.0) |
stars |
string |
no |
Star rating filter: 1–5 or any (default any) |
property_type |
string |
no |
Accommodation type filter (e.g. Hotels, Apartments) |
sort_by |
string |
no |
Sort criterion (default distance_from_search) |
max_results |
integer |
no |
Maximum listings to return (default 25, max 1000) |
| Field |
Type |
Description |
name |
string |
Official property name on Booking.com |
url |
string |
Direct URL to the hotel page |
type |
string |
Accommodation type |
stars |
number |
Official star rating (1–5) |
rating |
number |
Guest review score (1–10) |
ratingLabel |
string |
Label (e.g. Exceptional, Superb) |
reviews |
number |
Total guest review count |
price |
number |
Lowest nightly price in requested currency |
currency |
string |
Currency code |
breakfast |
boolean |
Whether breakfast is included |
rooms[].roomType |
string |
Room category name |
rooms[].available |
boolean |
Room availability for selected dates |
location.lat |
string |
Latitude coordinate |
location.lng |
string |
Longitude coordinate |
location.mainDistance |
string |
Distance from city centre |
- Providing
check_in and check_out is strongly recommended for accurate pricing.
- Use
min_score and stars together to target premium properties.
- Setting
max_results above 100 significantly increases response time.
- Build hotel comparison and booking aggregator tools with live Booking.com pricing data
- Enrich travel itinerary platforms with real-time accommodation options and availability
- Monitor competitor hotel pricing and market positioning across key destinations
- Power travel budget planners with dynamic nightly rate data per destination and dates
- Feed corporate travel management systems with curated hotel lists based on rating and price filters
