Hotel Price Tracker
구글 호텔 요금 캘린더는 한 호텔에 대해 앞으로 몇 주 동안 매일 체크인해 1박할 경우의 최저 요금을 나열한 것입니다. 이 1박 요금을 시간 순서로 보면 주중과 주말의 차이, 성수기 정점, 가장 저렴하게 예약할 수 있는 시점이 드러나 요금 추적, 수익 점검, 여행 계획에 도움이 됩니다.
Hotel Price Tracker API 주요 기능
- 캘린더를 행 단위로각 행이 하나의 체크인 날짜이며, check_out은 그다음 날이고 price.amount, price.currency, 형식이 적용된 요금이 그날 밤의 최저 요금을 나타냅니다.
- 한 번의 조회로 몇 주 분량한 번의 조회로 보통 6~8주 분량의 체크인 날짜를 담기 때문에 날짜마다 요금을 따로 조회할 필요가 없습니다.
- 시작일 지정check_in으로 캘린더 시작일을 정하고 check_out과 함께 지정합니다. 생략하면 내일부터 시작합니다.
- 호텔과 날짜로 행 식별각 행에 hotel_id와 name이 들어 있고, id는 호텔 ID와 체크인 날짜를 합친 값이라 반복 실행 결과를 쉽게 합칠 수 있습니다.
Hotel Price Tracker API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
hotel_id | 필수 | Google Hotels API 결과의 id 필드에 있는 호텔 ID. |
check_in | 선택 | 캘린더 시작일(YYYY-MM-DD, 오늘 이후). check_out과 함께 지정합니다. 둘 다 생략하면 내일부터 시작합니다. |
check_out | 선택 | 체크아웃 날짜(YYYY-MM-DD). check_in보다 늦어야 하며 최대 30박까지입니다. |
currency | 선택 | 1박 요금에 쓰는 3자리 통화 코드(USD, EUR 등). |
location_code | 선택 | 검색 시장의 위치 코드. 기본값은 2840(미국)입니다. |
language_code | 선택 | 결과 언어 코드. 기본값은 en입니다. |
Hotel Price Tracker API 사용 방법
호텔 ID를 보내고 체크인 날짜마다 한 행씩 읽습니다.
- {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"}를 /v1/google-hotels/hotel-prices에 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 날짜별 요금을 읽고, has_more가 true이면 results.next_cursor로 다음 페이지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-prices" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Hotel Price Tracker API 추천 활용 사례
- 가장 저렴한 날 찾기: price.amount로 정렬해 앞으로 몇 주 중 가장 저렴한 체크인 날짜를 골라 여행 일정을 짭니다.
- 주중과 주말 요금 차이: check_in의 요일별로 묶어 금요일·토요일 밤이 주중보다 얼마나 비싼지 계산합니다.
- 요금 변동 추적: 캘린더를 주기적으로 가져와 같은 id의 요금을 회차별로 비교하고, 호텔이 언제 요금을 올리거나 내렸는지 파악합니다.
- 경쟁 호텔 비교: 인근 여러 호텔의 캘린더를 같은 통화로 가져와 check_in별로 나란히 놓고 밤마다 가격 우위를 비교합니다.
Hotel Price Tracker API 활용 팁
- 호텔 ID와 체크인 날짜를 합친 id를 저장 키로 쓰면 매일 다시 실행해도 같은 밤의 데이터가 갱신될 뿐 중복 행이 생기지 않습니다.
- 더 먼 날짜를 보려면 check_in을 뒤로 옮겨 다시 요청하세요.
- 여러 호텔이나 여러 회차의 결과를 비교할 때는 currency를 고정하세요.
- 반환되는 날짜 수와 관계없이 요청 1건에 4크레딧이므로, 날짜마다 따로 조회하는 것보다 캘린더로 한 번에 가져오는 편이 저렴합니다.
관련 API
Hotel Price Tracker API 외에 Google Hotels의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Hotels API — 목적지로 구글 호텔을 검색해 호텔마다 지정한 일정의 1박 요금, 성급, 투숙객 평점, 리뷰 수, 좌표, 호텔 ID를 반환합니다.
- Google Hotel Details API — 호텔 ID로 구글 호텔의 프로필을 가져와 연락처, 편의시설, 주변 지역 점수, 평점 분포, 리뷰 주제, 예약 사이트별 요금을 반환합니다.