# Expedia rates: `POST /v1/ota/expedia`

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

Expedia's own rooms and rate plans.

Each offer has the upstream
stay `total` (Expedia labels it "Total with taxes and fees"), the upstream
`nightly` price before taxes, `taxes_and_fees` derived from the two (see
its provenance), cancellation terms read from the policy selector, and
the payment model. `available` is false with Expedia's own
`unavailable_reason` when the stay cannot be booked as asked - a minimum
stay, for instance. That answer is billed like any other: only a reply
with nothing in it is free.

Request body (JSON):

- `property_id` (string; required; min length 1, pattern ^\d+$): Numeric id returned by `POST /v1/ota/expedia/search`. For `expedia.com/Chicago-Hotels-Hilton-Chicago.h12570.Hotel-Information` it is `12570`. Not always the Hotels.com id: older properties differ between brands.
- `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 28): Length of stay. Ignored when `check_out` is supplied.
- `adults` (integer; optional; default 2; min 1, max 8): Adults in the room.
- `market` (string; optional; default US; one of CA, US): Expedia point-of-sale, which is how currency is selected - there is no currency field. `US` prices in USD on www.expedia.com, `CA` in CAD on www.expedia.ca. The display basis differs by market (the US room card leads with the stay total, CA with the nightly price), so compare within one market.
- `rooms` (boolean; optional; default true): Return every room type and rate plan. False returns the headline price only. Same credit cost.
- `country_market` (string | null; optional; one of CA, 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 expedia_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): `US` or `CA`.
  - `search_parameters.currency` (string; required): The market's currency (`USD` for `US`, `CAD` for `CA`).
  - `search_parameters.rooms` (boolean; required): Whether room types and rate plans were requested.
- `property` (object; required)
  - `property.property_id` (string; required)
  - `property.total` (number | null; required): Headline stay total for all nights; see `basis` and `taxes_and_fees_included`. Null when nothing priced.
  - `property.price_per_night` (number | null; required): Headline nightly price, before taxes and fees (Expedia rounds it to whole units).
  - `property.basis` (string | null; required; one of sticky_bar, cheapest_offer): Where the headline comes from: `sticky_bar` (the page's own headline price, read by its labels) or `cheapest_offer` (the cheapest priced offer). Null when nothing priced.
  - `property.total_text` (string; required): Headline total as displayed; empty when not shown.
  - `property.nightly_text` (string; required): Headline nightly price as displayed; empty when not shown.
  - `property.taxes_and_fees_included` (boolean | null; required): True when the headline total is labelled "with taxes and fees"; null when no such label was shown.
  - `property.fees_included` (boolean | null; required): True when the headline total is labelled "All fees included"; null when no such label was shown.
  - `property.currency` (string; required): Currency the point-of-sale actually priced in.
  - `property.currency_verified` (boolean; required): Whether `currency` equals the market's currency.
  - `property.available` (boolean; required): False when nothing is bookable for this stay as asked.
  - `property.unavailable_reason` (string | null; required): Expedia's own message when it says why the stay cannot be booked, e.g. `This property requires you to stay at least 4 nights`. Null otherwise; `available` can be false with a null reason when nothing priced.
  - `property.cheapest_total` (number | null; required): Lowest offer `total` across `rooms`; null when `rooms` was false or no offer priced.
  - `property.provenance` (object; required): Where, when and how one normalized price was observed.
- `rooms` (array of object; required): Every room type with its offers. Empty when the request set `rooms: false`.
  - `rooms[].unit_id` (string; required): Room type id. A vacation rental listed on Expedia is one room with `unit_id` = `property_id` and name `entire unit`.
  - `rooms[].name` (string; required): Room name as displayed, e.g. `Room, 1 King Bed`.
  - `rooms[].cheapest_total` (number | null; required): Lowest `total` among this room's offers; null when none priced.
  - `rooms[].offers` (array of object; required)
- `meta` (object; required)
  - `meta.source` (string; required; one of expedia)
  - `meta.collection_id` (string; required)
  - `meta.observed_at` (string; required)
  - `meta.nights` (integer; required)
  - `meta.elapsed_s` (number; required)
  - `meta.room_types` (integer; required): 0 when `rooms` was false.
  - `meta.offers` (integer; required): Offers across all rooms; 0 when `rooms` was false.
  - `meta.comparable_across_markets` (boolean; required): Always false: the display basis differs by market.

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)
