Hotel research and monitoring
Hotels.comエンドポイントを使えば、「Hotel research and monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Turn Hotels.com into structured JSON — anonymous destination and property-name suggestions, and static property metadata including rating, images, and amenities from a canonical property page, credential-free.
Get Hotels.com destination suggestions and public property detail — name, address, rating, images, and amenities — as structured JSON.
エンドポイントファミリー
6
ドキュメント化されたパラメータ
14
サンプル数
6
ライブカタログスナップショット
稼働エンドポイント
7
メソッド
GET, POST
必須パラメータ
14
スキーマ参照
7
{
"platform": "Hotels.com",
"endpoint": "hotels-autocomplete",
"method": "GET",
"path": "/hotels/autocomplete",
"auth": "apiKey"
}ユースケース
Get Hotels.com destination suggestions and public property detail — name, address, rating, images, and amenities — as structured JSON.
Hotels.comエンドポイントを使えば、「Hotel research and monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Hotels.comエンドポイントを使えば、「Destination discovery」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Hotels.comエンドポイントを使えば、「Travel content aggregation」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のHotels.comエンドポイントカタログから取得しています（エンドポイント7件、ドキュメント化されたリクエストパラメータ14個、公開レスポンススキーマ7件）。DocsとPlaygroundが参照しているカタログと同じものです。
Hotels.comのエンドポイントは7件、6つのリクエストファミリーに分類されています（Reviews、Autocomplete、Offersほか3件）。
これらのHotels.comエンドポイントには14個のリクエストパラメータがドキュメント化されており、うち14個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
7件のHotels.comエンドポイントのうち6件が実際のサンプルレスポンスを、7件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Hotels.comのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Hotels.comのエンドポイントは7個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/hotels/reviews
/hotels/autocomplete
/hotels/offers
/hotels/property
/hotels/rates
/hotels/search
エンドポイントカタログ
/hotels/autocompleteReturns anonymous Hotels.com search-box suggestions for a partial destination or property name. Availability and prices are not included.
レスポンスに関する注記
Returns anonymous destination and property suggestions from the Hotels.com search box. A valid no-match response has an empty `suggestions` array. Availability and prices are not included. ```json { "code": 200, "msg": "OK", "data": { "query": "New York", "suggestions": [ { "type": "SearchLocationBasicItem", "geo_type": "CITY", "region_id": "178293", "primary_text": "New York", "location_full_name": "New York, NY, United States", "latitude": 40.7128, "longitude": -74.006 } ] } } ```
MCPツール hotels_autocomplete
/hotels/offersReturns 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.
MCPツール hotels_offers
/hotels/propertyReturns 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.
レスポンスに関する注記
Returns public static property metadata. Date-bound availability, prices, booking, and review content are excluded. ```json { "code": 200, "msg": "OK", "data": { "property": { "id": "107229", "url": "https://www.hotels.com/ho107229/hilton-san-francisco-financial-district-san-francisco-united-states-of-america/", "name": "Hilton San Francisco Financial District", "address": { "locality": "San Francisco", "region": "California", "country": "US" }, "guest_rating": 8.4, "review_count": 1234, "amenities": ["Free WiFi", "Fitness center"] } } } ```
MCPツール hotels_property
/hotels/ratesReturns one Hotels.com property's date-bound rates and availability: the same normalized 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.
レスポンスに関する注記
Returns one property's date-bound rates and availability as the same normalized property card `/hotels/search` returns, with the live `price` (per-stay total), `strikeout_price`, and `nightly_price` for the requested dates. `properties` normally has one entry. An unknown property id, or one with no rates for the requested dates, returns `404`. ```json { "code": 200, "msg": "OK", "data": { "property_id": "19681371", "check_in": "2026-09-10", "check_out": "2026-09-11", "properties": [ { "id": "19681371", "name": "Pod Times Square", "url": "https://www.hotels.com/ho630803872/pod-times-square-new-york-united-states-of-america/", "review_score": 9.2, "review_count": 5901, "price": "$424", "strikeout_price": "$504", "nightly_price": "$369 nightly", "thumbnail_url": "https://images.trvl-media.com/lodging/..." } ] } } ```
MCPツール hotels_rates
/hotels/reviewsReturns 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.
レスポンスに関する注記
Returns the property's review overview: `overall_rating` on the 0-10 scale as displayed (e.g. `9.2/10`), a `superlative` label (e.g. `Wonderful`), per-category sub-ratings in `categories`, and a bounded set of highlighted guest reviews in `reviews` (reviewer, date, `8/10 Very good`-style rating label, message, and a `verified` flag). This mirrors the property page's Guest reviews section; the full paginated review archive is not exposed. An unknown property id returns `404`. ```json { "code": 200, "msg": "OK", "data": { "property_id": "19681371", "overall_rating": "9.2/10", "superlative": "Wonderful", "categories": [ {"name": "Cleanliness", "score": "9.2"}, {"name": "Amenities", "score": "8.4"}, {"name": "Service", "score": "9.2"} ], "reviews": [ { "reviewer_name": "Sheila", "date": "Aug 16, 2026", "rating_label": "8/10 Very good", "message": "Good 1 day stay", "verified": true } ] } } ```
MCPツール hotels_reviews
/hotels/reviews/archiveReturns 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.
レスポンスに関する注記
Returns one page of public guest reviews and `has_more`, which indicates that Hotels.com advertises another page for the same property and stay criteria. Use a later `page` value to continue. The endpoint excludes booking, account, payment, and private review data. ```json { "code": 200, "msg": "OK", "data": { "property_id": "19681371", "page": 1, "page_size": 10, "has_more": true, "reviews": [ { "id": "6a58fc8bac9dc27290ad8704", "reviewer_name": "Shulamit", "date": "Jul 16, 2026", "traveler_type": "Solo traveler", "rating_label": "10/10 Exceptional", "message": "Very convenient location and decent rooms." } ] } } ```
MCPツール hotels_reviews_archive
/hotels/searchReturns a page of date-bound Hotels.com hotel search results for either a free-text destination or a numeric Hotels.com region_id: normalized 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.
レスポンスに関する注記
Returns a page of date-bound search results with the live per-night and per-stay prices Hotels.com shows for the requested dates. Price fields are display strings: `price` is the per-stay total (`LEAD`), `strikeout_price` the crossed-out reference price, and `nightly_price` the per-night qualifier (e.g. `$369 nightly`). Each property's `url` is the canonical `/ho<id>/<slug>/` page (usable with `/hotels/property`) and its `id` is the numeric global property id usable with `/hotels/rates` and `/hotels/reviews`. A destination with no matches returns an empty `properties` array. ```json { "code": 200, "msg": "OK", "data": { "destination": "New York, New York, United States of America", "region_id": "2621", "check_in": "2026-09-10", "check_out": "2026-09-11", "page": 1, "properties": [ { "id": "19681371", "name": "Pod Times Square", "url": "https://www.hotels.com/ho630803872/pod-times-square-new-york-united-states-of-america/", "location": "New York", "review_score": 9.2, "review_count": 5901, "review_title": "Wonderful", "price": "$424", "strikeout_price": "$504", "nightly_price": "$369 nightly", "thumbnail_url": "https://images.trvl-media.com/lodging/...", "badges": ["Member Price $47 off"] } ] } } ```
MCPツール hotels_search
関連API
Travel & Hospitality
Build travel and lodging research workflows from structured Airbnb stay, room, availability, and review data.
Travel & Hospitality
Research hotels, restaurants, attractions, and destination pages from TripAdvisor with normalized listing and review endpoints.
Travel & Hospitality
Turn Expedia's Stays, Flights, and Things To Do results into structured JSON — destination search, hotel listings with pricing and reviews, flight offers, and activity search, sourced from the same API the official mobile app uses. Credential-free.
Hotels.comのスクレイピング方法
Crawlora's Hotels.com endpoints return anonymous destination suggestions and static property metadata as normalized JSON with one API key — no account or signed session required.
Send partial text to /hotels/autocomplete for Hotels.com's own search-box suggestions covering destinations and property names. Availability and prices are not included at this step.
Pass a canonical Hotels.com property page to /hotels/property (POST) for name, address, rating, images, and amenities. Date-bound availability, prices, booking, and review content are excluded — this is static property metadata only.
FAQ
Send a destination or property name to /hotels/autocomplete for suggestions, then a canonical property URL to /hotels/property for structured static metadata — name, address, rating, images, and amenities — with no account required.
No — /hotels/property returns static property metadata only. Date-bound availability, prices, booking, and guest-review content are excluded from this endpoint.
Collecting publicly accessible destination-suggestion and property metadata is generally permissible if you respect Hotels.com's terms of use, robots directives, rate limits, and applicable law. This is for public data you are authorized to collect.