Hotels APIhotels.com ↗
Search Hotels.com properties by destination and dates, get autocomplete suggestions, retrieve popular destinations, and find nearby hotels via a simple REST API.
What is the Hotels API?
The Hotels.com API exposes 4 endpoints for searching hotel availability, resolving destination names to region IDs, listing popular travel destinations, and finding nearby properties. The search_hotels endpoint returns up to 20 hotel listings per query, each carrying name, location, nightly price, total price, guest rating, review summary, image URL, and a direct booking link.
curl -X GET 'https://api.parse.bot/scraper/fa8d38aa-36ba-45d4-8191-f30d2d2e3c46/autocomplete_destination?query=Paris' \ -H 'X-API-Key: $PARSE_API_KEY'
Suggest destination names as a user types a query string. Returns matching cities, airports, neighborhoods, and points of interest with their region IDs, coordinates, and types. Use the returned region ID as input to search_hotels.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword for destination lookup (e.g. 'Istanbul', 'New York', 'Paris') |
{
"type": "object",
"fields": {
"destinations": "array of location objects each containing id, name, type, lat, long"
},
"sample": {
"data": {
"destinations": [
{
"id": "2734",
"lat": "48.853564",
"long": "2.348095",
"name": "Paris, France",
"type": "CITY"
},
{
"id": "6200422",
"lat": "48.862383",
"long": "2.339074",
"name": "Paris City Center, Paris, France",
"type": "NEIGHBORHOOD"
}
]
},
"status": "success"
}
}About the Hotels API
Destination Resolution and Hotel Search
Start with autocomplete_destination, which accepts a free-text query (e.g. 'Istanbul' or 'New York') and returns an array of location objects. Each object includes an id, name, type (city, airport, neighborhood, or point of interest), and coordinates (lat, long). Pass the returned id as the region_id parameter to search_hotels. Alternatively, get_popular_destinations returns a curated list of destination names and their IDs, so you can skip the autocomplete step for well-known cities.
Hotel Listings
search_hotels requires region_id, query, start_date, and end_date (both in YYYY-MM-DD format). Optional parameters rooms and adults let you scope occupancy. The response includes a total count and a hotels array. Each hotel object exposes id, name, location, rating, reviews_text, price_per_night, total_price, image_url, and a url pointing directly to the Hotels.com listing for that property.
Nearby Hotels
get_nearby_hotels takes a property_id sourced from search_hotels results and returns up to 20 competing or adjacent properties in the same format — id, name, location, rating, reviews_text, price_per_night, total_price, image_url, and url. The start_date and end_date parameters are optional here; omitting them defaults to tomorrow and the day after tomorrow respectively. rooms and adults are also accepted.
The Hotels API is a managed, monitored endpoint for hotels.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hotels.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official hotels.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a hotel price comparison tool by querying multiple destination region IDs from
get_popular_destinationsand comparingprice_per_nightacross results. - Power a travel chatbot that resolves user-typed city names via
autocomplete_destinationbefore fetching live availability fromsearch_hotels. - Generate a 'hotels near this property' feature in a travel app using
get_nearby_hotelswith aproperty_idfrom search results. - Track nightly price trends for specific destinations by periodically calling
search_hotelswith the sameregion_idand date range. - Populate a destination picker UI with pre-resolved region IDs from
get_popular_destinations, reducing the need for autocomplete calls. - Aggregate guest ratings and
reviews_textsnapshots across multiple cities to surface top-rated properties by destination. - Build an occupancy-aware search by varying
adultsandroomsparameters across identical date ranges to surface price differences.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Hotels.com have an official developer API?+
What does search_hotels actually return per hotel — is rating a numeric score or a label?+
hotels array includes a rating field and a reviews_text field. The rating carries the guest score as returned by Hotels.com, while reviews_text is the associated label (e.g. 'Wonderful' or 'Very good'). Both fields appear alongside price_per_night, total_price, image_url, and a direct url to the property listing.Does the API return room-level details, amenities, or cancellation policies?+
How many results does search_hotels return, and is there pagination?+
Can I filter search results by star rating, price range, or property type?+
search_hotels endpoint accepts region_id, query, start_date, end_date, rooms, and adults — there are no filter parameters for star rating, price range, or property type. Results are returned sorted by Hotels.com's recommendation order. You can fork this API on Parse and revise it to expose additional filter parameters.