google-hotels/
hotel-prices

호텔 ID로 구글 호텔의 요금 캘린더를 가져와 체크인 날짜별 최저 1박 요금을 반환합니다. 시작일부터 보통 6~8주 분량을 담습니다.

Hotel Price Tracker API

날짜별 요금 캘린더
체크인 날짜당 한 행
통화 지정
호텔 ID로 조회
요청당 4 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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를 보내고 체크인 날짜마다 한 행씩 읽습니다.

  1. {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"}를 /v1/google-hotels/hotel-prices에 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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크레딧이므로, 날짜마다 따로 조회하는 것보다 캘린더로 한 번에 가져오는 편이 저렴합니다.

Hotel Price Tracker API 외에 Google Hotels의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Google Hotels API — 목적지로 구글 호텔을 검색해 호텔마다 지정한 일정의 1박 요금, 성급, 투숙객 평점, 리뷰 수, 좌표, 호텔 ID를 반환합니다.
  • Google Hotel Details API — 호텔 ID로 구글 호텔의 프로필을 가져와 연락처, 편의시설, 주변 지역 점수, 평점 분포, 리뷰 주제, 예약 사이트별 요금을 반환합니다.

다른 플랫폼 둘러보기

Google Hotels 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Hotel Price Tracker API — 자주 묻는 질문

Hotel Price Tracker API는 호텔 ID로 구글 호텔의 요금 캘린더를 가져오는 API로, 앞으로 약 6~8주 동안 체크인 날짜별 최저 1박 요금을 반환합니다.

각 행은 1박 요금입니다. check_out은 check_in 다음 날이며, price는 그날 밤의 최저 요금입니다.

시작일부터 보통 6~8주입니다. check_in을 지정하면 그날부터, 생략하면 내일부터 시작합니다.

currency에 USD, EUR 같은 3자리 코드를 지정합니다. 각 행에 요금의 통화가 함께 표시됩니다.

요청 1건에 4크레딧이며, 호텔 한 곳의 캘린더 전체를 반환합니다.