Search for accommodations with price and quality optimization. Find top 5 best-rated stays and top 5 cheapest stays at any destination. Use when user needs hotel, hostel, or Airbnb recommendations, price comparisons for lodging, or neighborhood-based accommodation suggestions.
Find the perfect place to sleep — from budget to luxury.
python3 scripts/search_stays.py \
--city Bangkok \
--country TH \
--checkin 2025-05-15 \
--checkout 2025-05-20 \
--guests 2 \
--rooms 1
| Flag | Description | Example |
|---|---|---|
--city | City name | Bangkok, Tokyo, Bali |
--country | Country code | TH, JP, ID |
--checkin | Arrival date | 2025-05-15 |
--checkout | Departure date | 2025-05-20 |
--guests | Number of guests | 1, 2, 4 |
--rooms | Rooms needed | 1, 2 |
--type | Accommodation type | hotel, hostel, airbnb, any |
--neighborhood | Preferred area | Sukhumvit, Shibuya |
--min-rating | Minimum rating | 4.0, 8.0 |
--amenities | Must-have features | wifi,pool,breakfast |
--max-price | Budget limit per night | 100, 50 (USD) |
references/platform_apis.md - API integration guidesreferences/neighborhood_guides/ - Area recommendations by city