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

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

Resolve a hotel name to Expedia's numeric property identifier.

Add `city` to disambiguate brands, then store
`recommended_match.property_id` for
`POST /v1/ota/expedia`. It is null when only weak or ambiguous candidates
were found. Expedia ids match Hotels.com's for newer properties only.

Request body (JSON):

- `name` (string; required; min length 1): Hotel name as a guest would search for it.
- `city` (string; optional; default ): Strongly recommended. Sent with the name to Expedia's search and used to rank same-brand hotels in other cities lower.
- `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.
- `limit` (integer; optional; default 5; min 1, max 10): Maximum hotel candidates to return, best match first.

Response fields:

- `search_parameters` (object; required)
  - `search_parameters.engine` (string; required; one of expedia_search)
  - `search_parameters.name` (string; required)
  - `search_parameters.city` (string; required)
  - `search_parameters.market` (string; required): Point-of-sale searched: `US` (www.expedia.com) or `CA` (www.expedia.ca).
  - `search_parameters.limit` (integer; required)
- `search_status` (string; required; one of matched, ambiguous, not_found): `matched` only when the top candidate clears the identity threshold and margin.
- `recommended_match` (object | null; required): Safe to store; null unless `search_status` is `matched`.
  - `recommended_match.property_id` (string; required): Numeric Expedia id (digits); pass as `property_id` to `POST /v1/ota/expedia` or as `expedia_property_id` to `POST /v1/ota/compare`. Matches the Hotels.com id only for newer properties.
  - `recommended_match.name` (string; required)
  - `recommended_match.city` (string; required)
  - `recommended_match.address` (string; required)
  - `recommended_match.country` (string; required)
  - `recommended_match.url` (string; required): Expedia property page, `https://<host>/h<property_id>.Hotel-Information`.
  - `recommended_match.rank` (integer; required)
  - `recommended_match.score` (number; required)
  - `recommended_match.name_score` (number; required)
  - `recommended_match.identity_score` (number; required)
  - `recommended_match.match_score` (number; required)
  - `recommended_match.confidence` (string; required; one of high, medium, low)
  - `recommended_match.winner_reason` (string; required)
  - `recommended_match.city_score` (number; optional): Present only when `city` was supplied.
  - `recommended_match.coordinates` (object; optional): Present only when the source returned coordinates.
- `warnings` (array of string; required)
- `matches` (array of object; required): Candidates, best first, for manual review.
  - `matches[].property_id` (string; required): Numeric Expedia id (digits); pass as `property_id` to `POST /v1/ota/expedia` or as `expedia_property_id` to `POST /v1/ota/compare`. Matches the Hotels.com id only for newer properties.
  - `matches[].name` (string; required)
  - `matches[].city` (string; required)
  - `matches[].address` (string; required)
  - `matches[].country` (string; required)
  - `matches[].url` (string; required): Expedia property page, `https://<host>/h<property_id>.Hotel-Information`.
  - `matches[].rank` (integer; required)
  - `matches[].score` (number; required)
  - `matches[].name_score` (number; required)
  - `matches[].identity_score` (number; required)
  - `matches[].match_score` (number; required)
  - `matches[].confidence` (string; required; one of high, medium, low)
  - `matches[].winner_reason` (string; required)
  - `matches[].city_score` (number; optional): Present only when `city` was supplied.
  - `matches[].coordinates` (object; optional): Present only when the source returned coordinates.
- `meta` (object; required)
  - `meta.source` (string; required; one of expedia)
  - `meta.matches` (integer; required)
  - `meta.selection_method` (string; required)
  - `meta.match_threshold` (number; required)
  - `meta.match_margin` (number; required)
  - `meta.elapsed_s` (number; 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)
