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

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

Hotels.com headline price for one stay window.

`price_per_night` is the sticky bar's lead price, as it always was; on
the US and DE points-of-sale that is the stay total including taxes and
fees, so `price_per_night_is` says which it is and `total`/`nightly`
carry the labelled figures. An unbookable stay is `available: false`
with Hotels.com's own `unavailable_reason`, billed like any other
answer; only a reply with nothing in it is free.

Request body (JSON):

- `property_id` (string; required; min length 1): Numeric id returned by `POST /v1/ota/hotels/search`. For `hotels.com/h38766175.Hotel-Information` it is `38766175` — digits only, no leading `h`. The `ho…` number in a page URL is a legacy id the rate endpoints do not price.
- `check_in` (string (date); required): First night of the stay, `YYYY-MM-DD`.
- `check_out` (string (date) | null; optional): Departure date. An alternative to `nights` — if both are given, this wins.
- `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, which is how currency is selected — there is no currency field. **Prices are not comparable across markets**: the display basis differs, so the same night reads 527 USD on `US` and 585 CAD on `CA`, an implied 1.11 against a real rate near 1.37. Pick one market per comparison.
- `country_market` (string | null; optional; one of AU, CA, DE, EU, FR, GB, IE, IT, NL, NZ, US): StayAPI-style alias for `market` (the point-of-sale). Give one or the other; both must agree if both are given.
- `retry_min_stay` (boolean; optional; default false): When the source answers `availability: min_stay`, price that minimum stay once more and return it as `property.min_stay_quote` (its own dates, nights and provenance). The stay you asked for is never replaced. One extra upstream call, only when a minimum stay applies.

Response fields:

- `search_parameters` (object; required)
  - `search_parameters.engine` (string; required; one of hotels_property)
  - `search_parameters.property_id` (string; required)
  - `search_parameters.check_in_date` (string (date); required)
  - `search_parameters.check_out_date` (string (date); required)
  - `search_parameters.adults` (integer; required)
  - `search_parameters.market` (string; required)
  - `search_parameters.currency` (string; required): The market's currency.
- `property` (object; required)
  - `property.property_id` (string; required)
  - `property.price_per_night` (number | null; required)
  - `property.currency` (string; required): Currency the point-of-sale actually priced in.
  - `property.currency_verified` (boolean; required)
  - `property.available` (boolean; required)
  - `property.provenance` (object; required): Where, when and how one normalized price was observed.
- `meta` (object; required)
  - `meta.source` (string; required; one of hotels)
  - `meta.collection_id` (string; required)
  - `meta.observed_at` (string; required)
  - `meta.nights` (integer; required)
  - `meta.elapsed_s` (number; required)
  - `meta.comparable_across_markets` (boolean; required): Always false.

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)
