Expedia

GET
# Destination Search API

## Overview

Authenticate with X-API-Key. One successful call consumes one credit.

### Endpoint URL

GET https://api.stayapi.com/v1/expedia/search 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| region\_id | string | Required | Numeric string, up to 30 digits. |
| check\_in | date | Required | Strict YYYY-MM-DD. |
| check\_out | date | Required | Strict YYYY-MM-DD, checkout after check-in. |
| adults | integer | Optional | 1–8. Default: 2. |
| offset | integer | Optional | 0–1000. Default: 0. |
| limit | integer | Optional | 1–10. Default: 10. |
| currency | string | Optional | Supported currencies: USD, EUR, GBP, AUD, CAD, JPY, THB, SGD, HKD, INR, NZD, BRL, MXN, CHF, DKK, NOK, SEK, KRW, MYR, IDR, PHP, SAR, TWD, VND, AED, PEN, CLP, COP, EGP, ARS, CNY, ISK and ZAR. Default: USD. Whitespace is trimmed and letters are uppercased. |
| stars | string | Optional | Comma-separated star ratings 1–5, e.g. 4,5. Each level includes its half-star (4 includes 4.5). |
| min\_guest\_rating | integer | Optional | 7, 8 or 9 on a 10-point scale. Properties rated at least this. |
| sort | string | Optional | recommended (default), price\_low\_to\_high, price\_high\_to\_low, star\_rating or guest\_rating (highest first). |
| free\_cancellation | boolean | Optional | Default: false. Only properties with a free-cancellation price. |
| amenities | string | Optional | Comma-separated pool, free\_parking, free\_breakfast, pets. Properties must offer every listed amenity. |

Other filter values return 400. Resend the same filters with `next_offset`; if a requested filter cannot be confirmed as applied, the search returns 502 rather than unfiltered results.

## Response scope

Returns `region_id, region_name, check_in, check_out, adults, currency, offset, limit, sort, stars, min_guest_rating, free_cancellation, amenities, count, properties, next_offset, next_limit` and `availability_verified: false`. Each primary card has `property_id, name, canonical_url` and a nullable `price`. Prices are native regional quotes and can vary by market, not a fixed exchange-rate conversion. Property and room text may be localized for that market. Canonical URLs use the corresponding regional Expedia site. Discovery does not confirm availability. Continue only with the returned next\_offset/next\_limit pair; nullable continuation does not claim exhaustive inventory.

`price` contains the search result prices for your dates and adults: `total` is the whole stay in the requested currency and includes taxes and fees; `currency` identifies that currency; `per_night` is the displayed nightly price; its tax basis depends on the market; `total_before_discount` is the struck-through whole-stay price when available; a nightly-only discount does not populate this field. `per_night` and `total_before_discount` are null when not shown, and `price` is null when no price in the requested currency is available (for example, sold out). Displayed nightly amounts can be rounded. Compare stays with `total`; do not multiply `per_night` by nights. It is a search-result price, not a bookable offer: use [Expedia Hotel Rates](/docs/endpoints/expedia/hotel-rates) for bookable room offers. With `free_cancellation` or `amenities`, `price` reflects the matching rate, such as the refundable or breakfast-included price. Unpriced properties (`price: null`), including sold-out stays, can follow the available results and are not guaranteed to match every filter.

The filter fields echo what was applied: `sort`, `stars` (sorted, `[]` when unset), `min_guest_rating` (null when unset), `free_cancellation` and `amenities` (`[]` when unset).

Use returned property IDs with Expedia reviews or rates. REST only; no MCP tool.

## Errors

Unsupported currency codes return 400 Problem Details. Other invalid requests return 400 or 422 Problem Details. Upstream failures return 502, 503, or 504. Respect Retry-After when supplied; do not treat an error as empty results.

Request

```curl
curl 'https://api.stayapi.com/v1/expedia/search?region_id=3059&check_in=2027-02-10&check_out=2027-02-12' -H 'X-API-Key: YOUR_API_KEY'
```

Response

```json
{
  "region_id": "3059",
  "region_name": "Rovaniemi",
  "check_in": "2027-02-10",
  "check_out": "2027-02-12",
  "adults": 2,
  "currency": "USD",
  "offset": 0,
  "limit": 10,
  "sort": "recommended",
  "stars": [],
  "min_guest_rating": null,
  "free_cancellation": false,
  "amenities": [],
  "count": 2,
  "availability_verified": false,
  "properties": [
    {
      "property_id": "525650",
      "name": "Scandic Rovaniemi City",
      "canonical_url": "https://www.expedia.com/Rovaniemi-Hotels-Scandic-Rovaniemi-City.h525650.Hotel-Information",
      "price": {
        "total": 461.16,
        "currency": "USD",
        "per_night": 203.0,
        "total_before_discount": null
      }
    },
    {
      "property_id": "892285",
      "name": "Santa's Hotel Santa Claus",
      "canonical_url": "https://www.expedia.com/Rovaniemi-Hotels-Santas-Hotel-Santa-Claus.h892285.Hotel-Information",
      "price": {
        "total": 484.53,
        "currency": "USD",
        "per_night": 213.0,
        "total_before_discount": 538.0
      }
    }
  ],
  "next_offset": null,
  "next_limit": null
}
```

```json
{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid request parameters",
  "instance": "/v1/expedia/search",
  "provider": "expedia"
}
```
