Hotels.com API endpoint
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.
/hotels/reviews/archiveproperty_id (required): numeric global Hotels.com property id from hotels/search.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.page: 1-based review page. Defaults to 1.page_size: reviews per page, 1-20. Defaults to 10.currency: 3-letter currency code. Defaults to USD.locale: locale. Defaults to en_US.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.
| Field | Filled in, of 10 checked |
|---|---|
| id | 10 |
| reviewer_name | 10 |
| date | 10 |
| traveler_type | 9 |
| rating_label | 10 |
| message | 10 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| request (body) | object | Yes | Review archive request | ||
| x-api-key (header) | string | Yes | API key required |
curl -X POST "https://api.crawlora.net/api/v1/hotels/reviews/archive" \
-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","page":1,"page_size":10,"property_id":"19681371"}'{
"adults": 2,
"check_in": "2026-09-10",
"check_out": "2026-09-11",
"currency": "USD",
"locale": "en_US",
"page": 1,
"page_size": 10,
"property_id": "19681371"
}{
"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."
}
]
}
}Request schema
#/definitions/hotels.ReviewsArchiveOption
| 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 | |||
| page | integer | No | 1 | |||
| page_size | integer | No | 10 | |||
| property_id | string | Yes | 19681371 |
Response schema
#/definitions/hotels.reviewsArchiveResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | hotels.ReviewsArchiveResponse | No | ||||
| data.has_more | boolean | No | ||||
| data.page | integer | No | ||||
| data.page_size | integer | No | ||||
| data.property_id | string | No | ||||
| data.reviews | array | No | ||||
| data.reviews[].date | string | No | ||||
| data.reviews[].id | string | No | ||||
| data.reviews[].message | string | No | ||||
| data.reviews[].rating_label | string | No | ||||
| data.reviews[].reviewer_name | string | No | ||||
| data.reviews[].title | string | No | ||||
| data.reviews[].traveler_type | 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/archive" \
-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","page":1,"page_size":10,"property_id":"19681371"}'