booking-com.p.rapidapi.com APIbooking-com.p.rapidapi.com ↗
Search Booking.com hotels by location and retrieve structured property details: amenities, ratings, reviews, images, and pricing via two simple endpoints.
curl -X GET 'https://api.parse.bot/scraper/15bd80e1-56cd-4b5d-bb77-42d31d8b2067/search_properties?limit=3&query=Paris' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for hotel properties by location or keyword. Returns a list of properties with name, URL, price, and rating. Results do not include check-in/check-out date pricing unless dates are specified in the search query.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
| queryrequired | string | Search keyword such as city name, hotel name, or area (e.g. 'London', 'Paris', 'New York'). |
{
"type": "object",
"fields": {
"query": "string - the search query used",
"results": "array of property objects with name, url, price, rating, address",
"total_results": "integer - number of results returned"
},
"sample": {
"data": {
"query": "London",
"results": [
{
"url": "https://www.booking.com/hotel/gb/merlyn-court-greater-london1.html",
"name": "The Barkston",
"price": null,
"rating": "Scored 8.98.9Excellent97 reviews",
"address": null
}
],
"total_results": 5
},
"status": "success"
}
}About the booking-com.p.rapidapi.com API
The Booking.com API exposes 2 endpoints covering hotel search and property detail extraction, returning up to 9 structured fields per property including amenities, rating scores, review counts, and images. Use search_properties to find hotels by city or keyword, then pass any result URL to get_property_details to pull full structured data for a specific listing.
Endpoints
search_properties accepts a required query string — a city name, area, or hotel name — plus an optional limit integer to cap results. The response returns an array of property objects, each with name, url, price, rating, and address, along with a total_results count. Prices in search results reflect availability only when check-in and check-out dates are included in the query; otherwise the price field may be absent.
get_property_details takes a full Booking.com property URL and returns a richer dataset: name, address, rating_score (numeric, out of 10), rating_category (e.g. "Excellent", "Good"), review_count, description_text, an amenities array, and an images array of direct image URLs. The price field is present only when date parameters are embedded in the URL — passing a bare property URL without dates returns null for price.
Data Coverage
Rating data comes as both a numeric rating_score and a human-readable rating_category, which makes it straightforward to bucket properties without building your own thresholds. The amenities field is an array of facility strings (e.g. "Free WiFi", "Parking", "Swimming pool") as listed on the property page. Images are returned as an array of direct URLs, ready to use in any front-end display.
Limitations
Availability calendars, room-type breakdowns, and real-time inventory are not returned by either endpoint. Price data depends on dates being present in the URL or query — without dates, price is null. The API returns results in the default Booking.com locale and does not currently expose parameters for language or currency selection.
- Build a hotel comparison tool that ranks properties by
rating_scoreandreview_countacross multiple cities. - Aggregate
amenitiesarrays from dozens of listings to filter hotels that include specific facilities like parking or breakfast. - Populate a travel app's property cards using
name,address,images, andrating_categoryfromget_property_details. - Monitor price changes for a set of property URLs by polling
get_property_detailswith date-stamped URLs. - Create a destination guide that surfaces top-rated hotels per city using
search_propertieswith city names as queries. - Feed structured hotel metadata into a recommendation engine using
description_textandamenitiesfields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Booking.com have an official developer API?+
When does `get_property_details` return a non-null price?+
price field is populated only when check-in and check-out dates are embedded in the property URL you supply. A bare property URL (e.g. https://www.booking.com/hotel/gb/stgileshotel.html) without date query parameters returns null for price. To get pricing, append checkin and checkout date parameters to the URL before passing it to the endpoint.Does the API return room-type breakdowns or availability calendars?+
Can I paginate through large search result sets?+
search_properties accepts a limit parameter to cap the number of results returned, but there is no offset or page parameter exposed. The API returns a single batch of results up to the specified limit. You can fork this API on Parse and revise it to add pagination support for deeper result sets.Does the API support filtering search results by amenity, star rating, or price range?+
search_properties endpoint accepts only a query string and an optional limit — there are no server-side filter parameters for amenity type, star rating, or price range. Filtering must be done client-side against the returned rating and property fields. You can fork this API on Parse and revise it to add filter parameters if the underlying search supports them.