docs / lodging

Hotels & Rentals

Stays across the Expedia group — search and details.

base /lodging/v13 endpoints

post/lodging/v1/search2 credits

Search stays/hotels in a destination for given dates on a chosen brand site (Vrbo ≈50 / Expedia ≈97 properties per call, with prices and ratings).

Parameter		Allowed / range	Description
brand = expedia	optional	expedia · vrbo · hotelscom	Which Expedia-group site to search. Expedia is the most reliable; Vrbo can hit rate-limits under load. (orbitz/travelocity/hotwire open later.)
query	optional	—	Destination as free text — city/region ('Miami, Florida'). Provide query OR region_id.
region_id	optional	—	Advanced: exact destination region ID from `typeahead` (skips the destination lookup).
checkin	optional	—	Check-in date (YYYY-MM-DD). Prices depend on dates.
checkout	optional	—	Check-out date (YYYY-MM-DD).
adults = 2	optional	1–14	Number of adult guests.
children = 0	optional	0–10	Number of children.
currency = USD	optional	—	Price currency (ISO code). USD automatically mints hotels.com on a US exit so prices return in USD.
locale = en_US	optional	—	Response locale (en_US, en_GB, de_DE…).
include_raw = false	optional	—	Advanced: include the full raw response payload from the brand site.

Try in playground →

post/lodging/v1/property_detail3 credits

Full property record (browser-rendered page): rating, address, bedrooms, sleeps, property type, images, description.

Parameter		Allowed / range	Description
brand = expedia	optional	expedia · vrbo · hotelscom	Which Expedia-group site to search. Expedia is the most reliable; Vrbo can hit rate-limits under load. (orbitz/travelocity/hotwire open later.)
pdp_id	optional	—	The property's ID on the brand site — `pdp_id` from a search result. Provide pdp_id OR url.
url	optional	—	Full property page URL (alternative to pdp_id).
region_id	optional	—	Advanced: exact destination region ID from `typeahead` (skips the destination lookup).
adults = 2	optional	1–14	Number of adult guests.
checkin	optional	—	Check-in date (YYYY-MM-DD). Prices depend on dates.
checkout	optional	—	Check-out date (YYYY-MM-DD).
include_raw = false	optional	—	Advanced: include the full raw response payload from the brand site.

Try in playground →

post/lodging/v1/typeahead1 credit

Resolve a destination string to region IDs (cities, airports, neighborhoods) — the feeder for search's region_id.

Parameter		Allowed / range	Description
query	required	—	Destination text to resolve.
brand = expedia	optional	expedia · vrbo · hotelscom	Which Expedia-group site to search. Expedia is the most reliable; Vrbo can hit rate-limits under load. (orbitz/travelocity/hotwire open later.)

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/lodging/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"brand":"vrbo","query":"Miami, Florida","checkin":"2026-08-10","checkout":"2026-08-15","adults":2}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}