directrate

OTA channel

Hotels.com hotel rates API

Hotels.com rates for a property, tax-inclusive nightly, Member Price reported in its own field.

Public rate
✓
Member Price (reported apart)
✓
Award points
–
Native calendar
–
Comp set batch
–
Credits per shop
1
Comp set, per hotel
0.25
Calendar, per night
shop
  • ·Hotel code = the Hotels.com hotel id (the same id space as Expedia).
Start freeQuickstart
curl -s https://api.directrate.dev/v1/shop \
  -H "x-api-key: $DIRECTRATE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"chain":"hotelscom","hotel_code":"<hotel_code>","checkin":"2026-11-10","los":1}'

Find a Hotels.com code first: GET /v1/hotels?chain=hotelscom&q=<city> (1 credit).

# an OTA's hotel code is its own hotel id: the number in its URL, or
# the channel id a /parity call on the chain's hotel returns
curl -s https://api.directrate.dev/v1/parity \
  -H "x-api-key: $DIRECTRATE_API_KEY" -H "content-type: application/json" \
  -d '{"chain":"choice","hotel_code":"IL263","checkin":"2026-11-10","channels":["hotelscom"]}'
{
  "chain": "hotelscom",
  "hotel": {
    "code": "<hotel_code>",
    "name": "…",
    "currency": "USD"
  },
  "checkin": "2026-11-10",
  "los": 1,
  "status": "available",
  "rates": [
    {
      "room_name": "…",
      "rate_name": "…",
      "rate_type": "bar",
      "member_only": false,
      "price_per_night": 0,
      "price_per_night_after_tax": 0,
      "tax_included": true,
      "currency": "USD"
    }
  ],
  "lowest": {
    "bar": 0,
    "member": 0,
    "bar_after_tax": 0,
    "member_after_tax": 0
  },
  "shopped_at": "…",
  "source": "live",
  "cache_age_sec": 0
}

ShopResponse — the full schema is in the API reference.

No snapshot response is shown for Hotels.com on this page; the shape above is the contract every chain answers in. Run it live with a free key.

FAQ

Hotels.com questions

Where do I get a Hotels.com hotel id?

It is Hotels.com's own hotel id — the number in the listing URL — or the channel id that POST /parity on the chain's hotel returns after resolving the id map from Google Hotels. GET /hotels/{chain}/{code}/ids returns the mapping on its own.

Does the Hotels.com price include tax?

Every OTA rate is tax-inclusive on the comparable field price_per_night_after_tax; the row says which basis price_per_night is in.

Can I get points or a calendar from Hotels.com?

No — an OTA carries no award points and no native calendar, and a hotel-code search is not offered on it. Shop it directly, use it as a /parity channel, or /calendar it a night at a time (one shop per night).

All sources: coverage matrix · chains & coverage docs · weights.