# Hotels.com rooms: `POST /v1/ota/hotels/rooms`

Cost: 12 credits (12 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/hotels-rooms

Hotels.com room types and rate plans for one stay window.

The same answer as `/v1/ota/hotels` with the room grid included. Each
rate plan keeps its
`price` (the card's lead price; on the US and DE points-of-sale the stay
total including taxes and fees) and adds the labelled `total` and
`nightly`, a derived `taxes_and_fees`, the payment model and the
inventory source.

Heavier than the headline price, so use it on the dates that matter
rather than sweeping a horizon.

Request body (JSON):

- `property_id` (string; required; min length 1): Numeric id returned by `POST /v1/ota/hotels/search`, or from `hotels.com/h38766175.Hotel-Information` (not the legacy `ho…` number).
- `check_in` (string (date); required): First night of the stay, `YYYY-MM-DD`.
- `nights` (integer; optional; default 1; min 1, max 30): Length of stay. Ignored when `check_out` is supplied.
- `adults` (integer; optional; default 2; min 1, max 8): Adults in the room. Two is the hotel default; pass one for a hostel, which is priced per bed. Any value 1-8 works.
- `market` (string; optional; default US; one of AU, CA, DE, EU, FR, GB, IE, IT, NL, NZ, US): Point-of-sale; also selects the currency.

Response fields:

- `property_id` (string; required)
- `market` (string; required)
- `check_in` (string (date); required)
- `check_out` (string (date); required)
- `nights` (integer; required)
- `currency` (string; required)
- `sold_out` (boolean; required)
- `cheapest_rate` (number | null; required)
- `collection_id` (string; required)
- `observed_at` (string; required)
- `rooms` (array of object; required)
  - `rooms[].name` (string; required)
  - `rooms[].unit_id` (string; required)
  - `rooms[].cheapest_rate` (number | null; required)
  - `rooms[].rate_plans` (array of object; required)

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
