Search Stays by Destination
View all Booking.com Hotel & Travel Data endpoints →Search accommodation using a known destination query such as city:20088325 for New York, with explicit checkin_date, checkout_date, adults, rooms, and currency_code. The observed success body contains status=true, message=Success, currentPage, resultsPerPage, totalResultCount, and a data array. Hotel rows include id, name, ufi, countryCode, checkinDate, checkoutDate, reviewScore, coordinates, blockIds, and priceBreakdown.grossPrice with currency and value. A request for page_size=10 returned 20 rows; use returned pagination metadata instead of assuming that setting is enforced. Destination autocomplete is unavailable, so retain a known query rather than depending on name discovery. Prices and reported match counts can change.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/booking/stays-search API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/booking/stays-search?key=<API_KEY>&query=city%3A20088325'
Query Result
Use Cases
- Build a New York accommodation shortlist for a traveler-selected stay and guest count.
- Collect bounded city price snapshots while retaining retrieval time and the full stay context.
- Check returned ufi and countryCode before placing hotels on a destination map.
- Join selected listing id values to hotel details instead of enriching every search result.
Frequently asked questions
What query was validated for New York?
city:20088325 returned New York properties with ufi=20088325. Keep that city query separate from hotel_id; accommodation autocomplete is currently unavailable.
Does page_size cap the returned rows?
Not reliably in the observed call: page_size=10 returned 20 hotels, resultsPerPage=20, and totalResultCount=549. Those counts are historical observations, not permanent inventory or a promised page cap.
Can grossPrice be shown as the final payable amount?
Do not assume that. Inspect currency, the stay dates, and any excludedPrice or charge fields. This read provides a price snapshot and does not reserve inventory.