Docs menu

Hotels.com API endpoint

Hotels.com property rates API

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.

POSTapiKey3 credits/requestHotels.comhotels.RatesOptionhotels.ratesResponseDoc/hotels/rates

Endpoint facts

Method: POST
API path: /hotels/rates
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Hotels.com
Response schema: #/definitions/hotels.ratesResponseDoc
Request body schema: #/definitions/hotels.RatesOption

Hotels.com API Try Hotels.com property rates API in Playground Hotels.com API documentation

How this endpoint behaves

Body parameters

property_id (required): numeric global property id, e.g. 19681371 — the properties[].id value from /hotels/search. This is distinct from the legacy /ho<id>/ URL id.
check_in (required): YYYY-MM-DD check-in date.
check_out (required): YYYY-MM-DD check-out date, after check_in.
adults: adults, 1-9. Defaults to 2 when 0.
currency: 3-letter currency code, e.g. USD. Defaults to USD.
locale: locale, e.g. en_US. Defaults to en_US.

Response behavior

Returns one property's date-bound rates and availability as the same 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.

Live monitoring

Monitored request: POST /hotels/rates
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.43 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: POST /hotels/rates
Items in properties: 1
Fields filled in every checked item: 11

Field	Filled in, of 1 checked	Values in the sample
id	1
name	1	“Pod Times Square”
url	1	hotels.com
review_score	1	9
review_count	1	6,171
review_title	1	“Wonderful”
price	1	“$331 total”
strikeout_price	1	“$364”
nightly_price	1	“$259 nightly”
thumbnail_url	1	images.trvl-media.com
badges	1	median 1 entry

Request parameters

Parameter	Type	Required	Default	Description	Example
request (body)	object	Yes		Rates request
x-api-key (header)	string	Yes		API key required

cURL example

curl -X POST "https://api.crawlora.net/api/v1/hotels/rates" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":2,"check_in":"2026-09-10","check_out":"2026-09-11","currency":"USD","locale":"en_US","property_id":"19681371"}'

Request body example

{
  "adults": 2,
  "check_in": "2026-09-10",
  "check_out": "2026-09-11",
  "currency": "USD",
  "locale": "en_US",
  "property_id": "19681371"
}

Example JSON response

{
  "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/..."
      }
    ]
  }
}

Request schema

#/definitions/hotels.RatesOption

Field	Type	Required	Example
adults	integer	No	2
check_in	string	Yes	2026-09-10
check_out	string	Yes	2026-09-11
currency	string	No	USD
locale	string	No	en_US
property_id	string	Yes	19681371

Response schema

#/definitions/hotels.ratesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	hotels.RatesResponse	No
data.check_in	string	No
data.check_out	string	No
data.properties	array	No
data.properties[].amenities	array	No
data.properties[].badges	array	No
data.properties[].id	string	No
data.properties[].location	string	No
data.properties[].name	string	No
data.properties[].nightly_price	string	No
data.properties[].price	string	No
data.properties[].review_count	integer	No
data.properties[].review_score	number	No
data.properties[].review_title	string	No
data.properties[].strikeout_price	string	No
data.properties[].thumbnail_url	string	No
data.properties[].url	string	No
data.property_id	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X POST "https://api.crawlora.net/api/v1/hotels/rates" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":2,"check_in":"2026-09-10","check_out":"2026-09-11","currency":"USD","locale":"en_US","property_id":"19681371"}'

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Hotels.com endpoint docs Hotels.com API Hotels.com Autocomplete API documentation Hotels.com room offers API documentation Hotels.com property details API documentation Hotels.com property reviews API documentation Hotels.com review archive API documentation Hotels.com hotel search API documentation

Open in Playground Back to group

Docs menu

Hotels.com API endpoint

Hotels.com property rates API

POSTapiKey3 credits/requestHotels.comhotels.RatesOptionhotels.ratesResponseDoc/hotels/rates

Endpoint facts

Method: POST
API path: /hotels/rates
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Hotels.com
Response schema: #/definitions/hotels.ratesResponseDoc
Request body schema: #/definitions/hotels.RatesOption

Hotels.com API Try Hotels.com property rates API in Playground Hotels.com API documentation

How this endpoint behaves

Body parameters

property_id (required): numeric global property id, e.g. 19681371 — the properties[].id value from /hotels/search. This is distinct from the legacy /ho<id>/ URL id.
check_in (required): YYYY-MM-DD check-in date.
check_out (required): YYYY-MM-DD check-out date, after check_in.
adults: adults, 1-9. Defaults to 2 when 0.
currency: 3-letter currency code, e.g. USD. Defaults to USD.
locale: locale, e.g. en_US. Defaults to en_US.

Response behavior

Live monitoring

Monitored request: POST /hotels/rates
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.43 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: POST /hotels/rates
Items in properties: 1
Fields filled in every checked item: 11

Field	Filled in, of 1 checked	Values in the sample
id	1
name	1	“Pod Times Square”
url	1	hotels.com
review_score	1	9
review_count	1	6,171
review_title	1	“Wonderful”
price	1	“$331 total”
strikeout_price	1	“$364”
nightly_price	1	“$259 nightly”
thumbnail_url	1	images.trvl-media.com
badges	1	median 1 entry

Request parameters

Parameter	Type	Required	Default	Description	Example
request (body)	object	Yes		Rates request
x-api-key (header)	string	Yes		API key required

cURL example

curl -X POST "https://api.crawlora.net/api/v1/hotels/rates" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":2,"check_in":"2026-09-10","check_out":"2026-09-11","currency":"USD","locale":"en_US","property_id":"19681371"}'

Request body example

{
  "adults": 2,
  "check_in": "2026-09-10",
  "check_out": "2026-09-11",
  "currency": "USD",
  "locale": "en_US",
  "property_id": "19681371"
}

Example JSON response

{
  "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/..."
      }
    ]
  }
}

Request schema

#/definitions/hotels.RatesOption

Field	Type	Required	Example
adults	integer	No	2
check_in	string	Yes	2026-09-10
check_out	string	Yes	2026-09-11
currency	string	No	USD
locale	string	No	en_US
property_id	string	Yes	19681371

Response schema

#/definitions/hotels.ratesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	hotels.RatesResponse	No
data.check_in	string	No
data.check_out	string	No
data.properties	array	No
data.properties[].amenities	array	No
data.properties[].badges	array	No
data.properties[].id	string	No
data.properties[].location	string	No
data.properties[].name	string	No
data.properties[].nightly_price	string	No
data.properties[].price	string	No
data.properties[].review_count	integer	No
data.properties[].review_score	number	No
data.properties[].review_title	string	No
data.properties[].strikeout_price	string	No
data.properties[].thumbnail_url	string	No
data.properties[].url	string	No
data.property_id	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X POST "https://api.crawlora.net/api/v1/hotels/rates" \
  -H "x-api-key: $CRAWLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":2,"check_in":"2026-09-10","check_out":"2026-09-11","currency":"USD","locale":"en_US","property_id":"19681371"}'

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Hotels.com property rates API

Endpoint facts

How this endpoint behaves

Body parameters

Response behavior

Live monitoring

Sampled response

Request parameters

cURL example

Request body example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Hotels.com property rates API

Endpoint facts

How this endpoint behaves

Body parameters

Response behavior

Live monitoring

Sampled response

Request parameters

cURL example

Request body example

Example JSON response

Failure responses

Code examples

Shared guides

Related