Google Hotel Details
구글 호텔 상세 페이지에는 주소, 전화번호, 체크인 시간, 편의시설 목록과 함께 별점별 비율, 위치나 조식 같은 주제별 긍정·부정 언급 수, 다른 리뷰 사이트의 평점처럼 투숙객의 목소리가 모여 있습니다. 같은 숙박에 대해 각 예약 사이트와 호텔 공식 사이트가 제시하는 요금까지 더하면 요금 일관성 점검, 경쟁 호텔 비교, 호텔 소개 페이지 보강에 활용할 수 있습니다.
Google Hotel Details API 주요 기능
- 예약 사이트별 요금offers에는 판매처별 1박 요금과 예약 링크가 들어 있고, is_official, is_sponsored, free_cancellation_until로 공식 요금, 광고, 무료 취소 가능 요금을 구분할 수 있습니다.
- 투숙객이 이야기하는 주제review_topics는 Wellness, Breakfast 같은 주제별로 positive_count, negative_count, mentions_count를 반환해 숙박의 어떤 부분이 호평 또는 혹평을 받는지 보여 줍니다.
- 평점 분포와 다른 사이트 평점rating_distribution은 별점별 리뷰 비율을, other_reviews는 Tripadvisor 등 다른 사이트의 평점, 리뷰 수, 발췌문을 반환합니다.
- 주변 지역 점수location_scores는 종합, 즐길 거리, 음식점, 대중교통, 공항 접근성을 1~5점으로 평가하며 지역 이름과 좌표도 함께 제공합니다.
- 호텔 기본 정보를 한 행에address, phone, website, check_in_time, check_out_time, 이용 가능한 편의시설, 소개 문구, 사진이 함께 반환됩니다.
- 지정 일정 기준 요금check_in, check_out, currency로 요금 기준 숙박을 지정할 수 있으며, 일정을 생략하면 내일부터 1박 요금이 반환됩니다.
Google Hotel Details API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
hotel_id | 필수 | Google Hotels API 결과의 id 필드에 있는 호텔 ID. |
check_in | 선택 | 체크인 날짜(YYYY-MM-DD, 오늘 이후). check_out과 함께 지정합니다. 둘 다 생략하면 내일부터 1박 요금이 반환됩니다. |
check_out | 선택 | 체크아웃 날짜(YYYY-MM-DD). check_in보다 늦어야 하며 최대 30박까지입니다. |
currency | 선택 | 요금에 쓰는 3자리 통화 코드(USD, EUR 등). |
location_code | 선택 | 검색 시장의 위치 코드. 기본값은 2840(미국)입니다. |
language_code | 선택 | 호텔 상세 정보의 언어 코드. 기본값은 en입니다. |
Google Hotel Details API 사용 방법
호텔 검색에서 얻은 호텔 ID를 보내고 해당 호텔을 한 행으로 읽습니다.
- {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"}를 /v1/google-hotels/hotel-details에 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 호텔을 읽습니다. has_more와 results.next_cursor는 일반 페이지 규칙을 따르며, 이 한 행짜리 결과에서는 비어 있습니다.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'Google Hotel Details API 추천 활용 사례
- 요금 일관성 점검: is_official 공식 요금과 같은 일정의 온라인 여행사 요금을 비교해 공식 요금보다 싸게 판매하는 판매처를 찾습니다.
- 경쟁 호텔 비교: 인근 호텔들의 rating_distribution, review_topics, location_scores를 나란히 놓고 어디에서 앞서고 뒤처지는지 확인합니다.
- 호텔 소개 페이지 보강: 주소, 편의시설, 체크인 시간, 사진, 주변 지역 점수를 한 번의 조회로 가져와 여행 서비스의 호텔 페이지에 반영합니다.
- 투숙객 의견 분석: review_topics를 negative_count가 많은 순으로 정렬해 소음이나 조식처럼 불만이 많은 항목을 찾아냅니다.
Google Hotel Details API 활용 팁
- 최근 Google Hotels API 검색에서 얻은 호텔 ID를 사용하면 2크레딧 요청마다 원하는 호텔을 정확히 받을 수 있습니다.
- 검색할 때와 같은 check_in, check_out, currency를 지정하면 예약 사이트 요금이 검색 결과의 요금과 맞춰집니다.
- 판매처를 비교하기 전에 is_sponsored로 광고를 제외하면 비교 결과가 한쪽으로 치우치지 않습니다.
- 평점 분포를 차트로 그릴 때는 rating_distribution.share를 0~1 사이의 비율로 다루세요.
관련 API
Google Hotel Details API 외에 Google Hotels의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Hotels API — 목적지로 구글 호텔을 검색해 호텔마다 지정한 일정의 1박 요금, 성급, 투숙객 평점, 리뷰 수, 좌표, 호텔 ID를 반환합니다.
- Hotel Price Tracker API — 호텔 ID로 구글 호텔의 요금 캘린더를 가져와 앞으로 약 6~8주 동안 체크인 날짜별 최저 1박 요금을 반환합니다.