GET/hotels/autocompleteapiKey1 credit/request
Returns Hotels.com search-box suggestions for a partial destination or property name in `q` (up to 120 characters). Each suggestion has its type, primary and secondary text, full location name, coordinates, and region or property id. A query with no match returns an empty `suggestions` list.
Required: q.
Sampled 14 Oct 2026: 9 items. Filled in every item: type, primary_text, location_full_name. Not in every item: geo_type (8), region_id (8), secondary_text (8), latitude (8), longitude (8), airport_code (2). In the sample: geo_type: NEIGHBORHOOD (3), CITY (2), AIRPORT (2) and 1 more; primary_text: “New York” and 8 other values; secondary_text: New York, United States (4), New York, New York, United Stat… (4).
Open in Playground
POST/hotels/offersapiKey4 credits/request
Returns the public room/unit offer summaries shown for one Hotels.com property and date range, including room labels and non-transactional offer messages. Booking, checkout, payment, and reservation tokens are never returned. property_id is the numeric global property id from a Search response.
Required: request.
Sampled 14 Oct 2026: 4 items. Filled in every item: id. Not in every item: name (1). In the sample: name: “Our lowest price”.
Open in Playground
POST/hotels/propertyapiKey3 credits/request
Returns public static metadata from one canonical Hotels.com property page, including name, address, rating, images, and amenities. Date-bound availability, prices, booking, and review content are excluded.
Required: request.
Open in Playground
POST/hotels/ratesapiKey3 credits/request
Returns one Hotels.com property's date-bound rates and availability: the same property card Search returns, with the live per-night and per-stay prices Hotels.com shows for the requested dates. property_id is the numeric global property id from a Search response's properties[].id; it is distinct from the legacy /ho<id>/ URL id.
Required: request.
Sampled 14 Oct 2026: 1 item. Filled in every item: id, name, url, review_score, review_count, review_title, price, strikeout_price and 3 more. In the sample: name: “Pod Times Square”; url: hotels.com; badges: median 1 entry; review_title: “Wonderful”; price: “$331 total”; strikeout_price: “$364”; nightly_price: “$259 nightly”; thumbnail_url: images.trvl-media.com.
Open in Playground
POST/hotels/reviewsapiKey3 credits/request
Returns one Hotels.com property's review overview: the overall rating (0-10) with its descriptive label, the per-category sub-ratings (cleanliness, service, amenities, and so on), and a bounded set of highlighted guest reviews with reviewer, date, rating label, text, and verified-stay flag. property_id is the numeric global property id from a Search response's properties[].id. This mirrors the property page's Guest reviews section; the full paginated review archive is not exposed.
Required: request.
Sampled 14 Oct 2026: 6 items. Filled in every item: date, rating_label, message. In the sample: rating_label: 8 to 10, median 10.
Open in Playground
POST/hotels/reviews/archiveapiKey4 credits/request
Returns one page of public guest reviews for a Hotels.com property, including reviewer, date, traveler type, rating label, title, and message. Use page and page_size to walk the archive; the response reports whether another page is available. property_id is the numeric global property id from a Search response's properties[].id. Booking, account, and private review data are not included.
Required: request.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, reviewer_name, date, rating_label, message. Not in every item: traveler_type (9).
Open in Playground
POST/hotels/searchapiKey5 credits/request
Returns a page of date-bound Hotels.com hotel search results for either a free-text destination or a numeric Hotels.com region_id: property cards with per-night and per-stay prices, review score and count, location, thumbnail, amenities, and promotional badges. Provide exactly one of query or region_id; region_id skips destination typeahead resolution. Prices are the live rates Hotels.com shows for the requested check-in and check-out dates.
Required: request.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, name, url, location, review_score, review_count, review_title, price and 2 more. Not in every item: strikeout_price (16), badges (15), amenities (2). In the sample: location: New York (15), Theater District (5); review_score: 8 to 9.4, median 8.8; name: “PUBLIC, an Ian Schrager hotel” and 19 other values; url: hotels.com; badges: median 1 entry; review_count: 174 to 7,458, median 3,352; review_title: Excellent (8), Wonderful (5), Very Good (4) and 1 more; price: “$904 total” and 19 other values.
Open in Playground