호텔 재고는 방대하고 요금은 빠르게 변합니다. 이 숙소 API는 공개 장소 검색, 도시·호텔 모드의 재고 조회, 홀드 창이 있는 요금 검증, 그리고 예약 후 확정이라는 명확한 흐름을 제공합니다.
하나의 숙박 API가 글로벌 체인부터 독립 부티크까지 수백만 개의 숙소 앞에 섭니다. 재고, 식사 조건, 취소 정책, 세금이 하나의 형식과 통화로 도착하므로, 호텔 예약 웹사이트나 앱이 수십 가지 공급사 형식을 맞출 필요가 없습니다.
제공 기능
공개 장소 검색은 자동완성 입력창에 바로 연결됩니다.
하나의 재고 엔드포인트로 도시 전체를 나열하거나, 단일 호텔의 객실을 펼쳐 볼 수 있습니다.
요금을 검증하고 객실을 홀드한 뒤, 확정하고 청구합니다. 모두 USD로.
하나의 엔드포인트에서 도시·호텔 검색을 모두 지원해, 도시 전체부터 단일 숙소까지 다룹니다.
요금 검증이 짧은 홀드 창을 열어, 보여준 가격 그대로 예약됩니다.
흐름은 이렇게 동작합니다
Resolve
Turn a destination string into a place id with public place search.
Search
List availability for a whole city, or open a single property with its rooms.
Validate
Confirm the live rate and open a short hold window.
Book
Place the order and confirm; your balance is charged on confirmation.
주요 엔드포인트
/Hotel/PlaceSearchResolve a destination into a place id./v2/Hotel/HotelAvailabilityList availability in city or hotel mode./Hotel/RateValidateValidate the selected rate and hold it./Hotel/HotelBookCreate and confirm the booking./Hotel/BookingDetailsRetrieve a booking and its status.요청과 응답
{
"CheckIn": "2026-11-14",
"CheckOut": "2026-11-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}{
"hotels": [
{
"hotelId": "HTL-9931",
"name": "Marina Suites",
"stars": 4,
"lowestRate": {
"amount": 180.00, "currency": "USD", "board": "BB"
},
"rooms": [ { "code": "DLX-K", "refundable": true } ]
}
]
}응답에 포함되는 것
hotelId- Stable id for the property.
lowestRate- Cheapest bookable rate, in USD, with board type.
rooms- Room options with codes and refundability.
cancellationPolicy- Deadlines and penalties that apply to the rate.
hold- Minutes the validated rate stays bookable.
전 세계 호텔
자주 묻는 질문
목적지를 어떻게 검색으로 바꾸나요?
공개 장소 검색으로 텍스트를 id로 변환한 뒤, 그 id를 재고 조회에 전달하세요.
검증된 요금은 얼마나 유효한가요?
15분입니다. 반환된 요금 코드로 그 시간 안에 예약하세요.
잔액은 언제 청구되나요?
주문을 확정할 때만 청구됩니다. 예약은 청구 없이 객실을 홀드합니다.
요금에 세금과 수수료가 포함되나요?
네. 각 요금은 통화, 식사 조건, 세금·수수료 내역을 담고 있으며 모두 USD로 정규화됩니다.
단일 숙소를 바로 열 수 있나요?
네. 호텔 모드는 객실과 함께 한 숙소를 열고, 도시 모드는 목적지 전체를 나열합니다.