hotels.com APIhotels.com ↗
Search Hotels.com properties by destination and dates, get room availability and pricing, retrieve full property details, and look up popular destinations.
curl -X GET 'https://api.parse.bot/scraper/fa8d38aa-36ba-45d4-8191-f30d2d2e3c46/autocomplete_destination?query=New+York' \ -H 'X-API-Key: $PARSE_API_KEY'
Suggest destination names as a user types a query string. Returns matching cities, airports, and neighborhoods with their region IDs, coordinates, and types.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword for destination lookup (e.g. 'Istanbul', 'New York', 'Paris') |
{
"type": "object",
"fields": {
"data": "array of location objects each containing id, name, type, lat, long",
"status": "string indicating success"
},
"sample": {
"data": [
{
"id": "1639",
"lat": "41.01357",
"long": "28.96352",
"name": "Istanbul, Istanbul, Türkiye",
"type": "CITY"
},
{
"id": "553248635974515940",
"lat": "41.258501",
"long": "28.742676",
"name": "Istanbul, Türkiye (IST)",
"type": "AIRPORT"
},
{
"id": "6063107",
"lat": "41.00672778184033",
"long": "28.97695235993852",
"name": "Sultanahmet, Istanbul, Istanbul, Türkiye",
"type": "NEIGHBORHOOD"
}
],
"status": "success"
}
}About the hotels.com API
The Hotels.com API exposes 5 endpoints covering destination autocomplete, hotel search, room availability, property details, and popular destinations. Starting with autocomplete_destination, you can resolve a partial city or neighborhood name into a region_id and coordinate pair, then pass that directly into search_hotels to retrieve a live list of matching properties with pricing for specific check-in and check-out dates.
Destination Discovery
autocomplete_destination accepts a partial query string (e.g. "Istanbul" or "JFK") and returns an array of location objects, each with an id, name, type (city, airport, neighborhood), and lat/long coordinates. The id field is the region_id required by search_hotels. get_popular_destinations returns a curated list of destination names and IDs with no inputs required — useful for populating a home screen or seeding a destination picker without any user input.
Hotel Search and Room Availability
search_hotels takes a region_id, start_date, end_date (both in YYYY-MM-DD format), optional rooms count, and optional adults count. It returns a data object containing a hotels array and a total count. Each hotel object in the array includes enough detail to identify and link to a specific property. To go deeper, pass a property_id from the search results into get_hotel_rooms, which returns an array of available room types with per-room pricing for the requested dates, guest count, and room count.
Full Property Details
get_hotel_details accepts a single property_id and returns the full detail object for that property — amenities, descriptions, images, location metadata, and policy information as exposed by Hotels.com. This endpoint requires no date inputs, making it suitable for building property profile pages or caching baseline hotel metadata independently of availability lookups.
Data Flow
The typical usage pattern chains the endpoints: get_popular_destinations or autocomplete_destination → search_hotels → get_hotel_details and/or get_hotel_rooms. The region_id from autocomplete is the key join field across the destination and search layers, and property_id from search results is the key join field for the detail and room endpoints.
- Build a hotel search widget that resolves typed city names to region IDs via autocomplete_destination before querying availability
- Display live room pricing and availability for a specific property using get_hotel_rooms with date and guest parameters
- Aggregate hotel metadata (amenities, images, policies) from get_hotel_details for a travel comparison tool
- Populate a destination discovery carousel using get_popular_destinations with no user input required
- Monitor nightly rate changes across multiple Hotels.com properties by polling get_hotel_rooms on a schedule
- Map hotel coordinates returned by autocomplete_destination to visualize destination coverage on a travel planning map
- Feed hotel search results from search_hotels into a price-alert system keyed on property_id and date range
| 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.