Hotels.com API endpoint
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.
/hotels/reviewsproperty_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.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.
| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| date | 6 | |
| rating_label | 6 | 8 to 10, median 10 |
| message | 6 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| request (body) | object | Yes | Reviews request | ||
| x-api-key (header) | string | Yes | API key required |
curl -X POST "https://api.crawlora.net/api/v1/hotels/reviews" \
-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"}'{
"adults": 2,
"check_in": "2026-09-10",
"check_out": "2026-09-11",
"currency": "USD",
"locale": "en_US",
"property_id": "19681371"
}{
"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
}
]
}
}Request schema
#/definitions/hotels.ReviewsOption
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| 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.reviewsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | hotels.ReviewsResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].name | string | No | ||||
| data.categories[].score | string | No | ||||
| data.overall_rating | string | No | ||||
| data.property_id | string | No | ||||
| data.reviews | array | No | ||||
| data.reviews[].date | string | No | ||||
| data.reviews[].message | string | No | ||||
| data.reviews[].rating_label | string | No | ||||
| data.reviews[].reviewer_name | string | No | ||||
| data.reviews[].verified | boolean | No | ||||
| data.superlative | string | No | ||||
| msg | string | No | OK |
| 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 |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X POST "https://api.crawlora.net/api/v1/hotels/reviews" \
-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"}'