API 목록으로 돌아가기
Google Hotels 데이터

Google Hotels Data APIs

목적지로 호텔을 검색하고, 원하는 호텔의 구글 호텔 프로필 전체와 1박 요금 캘린더를 가져옵니다. 세 API는 같은 호텔 ID로 연결됩니다.

사용할 수 있는 Google Hotels API

먼저 Google Hotels API로 호텔과 호텔 ID를 찾고, Google Hotel Details API로 호텔 한 곳의 프로필과 요금을, Hotel Price Tracker API로 체크인 날짜별 요금을 가져옵니다.

어떤 Google Hotels 데이터를 가져올 수 있나요?

각 행은 호텔 한 곳 또는 하룻밤을 나타내며, 요금은 지정한 통화로 반환되고 호텔 ID가 세 API를 연결합니다.

요금이 포함된 호텔 목록

호텔 이름, 순위, 지정한 일정의 최저 1박 요금, 광고 여부, 구글 호텔 페이지 링크.

평점과 투숙객 리뷰

성급, 1~5점 투숙객 평균 평점, 리뷰 수, 별점별 비율, 리뷰 주제별 긍정·부정 언급 수.

예약 사이트별 요금

판매처별 1박 요금과 예약 링크. 호텔 공식 사이트, 광고, 무료 취소 가능 요금을 구분합니다.

위치와 주변 지역

주소, 좌표, 지역 이름, 즐길 거리·음식점·대중교통·공항 접근성의 1~5점 평가.

1박 요금 캘린더

호텔 한 곳의 체크인 날짜별 최저 요금. 보통 앞으로 6~8주 분량입니다.

어떤 Google Hotels API를 쓸까

세 API는 같은 호텔 ID를 사용하므로 검색 결과를 상세 정보나 요금 캘린더 요청에 바로 넘길 수 있습니다.

API입력반환 내용
Google Hotels APIquery에 목적지 또는 호텔 이름최대 140개 호텔. 1박 요금, 성급, 평점, 리뷰 수, 좌표, 호텔 ID
Google Hotel Details APIhotel_id 1개한 행. 연락처, 편의시설, 주변 지역 점수, 평점 분포, 리뷰 주제, 예약 사이트별 요금
Hotel Price Tracker APIhotel_id 1개체크인 날짜마다 한 행. 그날 밤의 최저 요금, 보통 앞으로 6~8주

Google Hotels API 작동 방식

세 API 모두 같은 비동기 작업 흐름을 사용합니다.

  1. 1. 호텔 찾기

    목적지를 /v1/google-hotels/search에 POST하고, 계속 살펴볼 호텔의 id를 저장합니다.

  2. 2. 자세히 보기

    hotel_id를 /v1/google-hotels/hotel-details에 POST해 프로필과 요금을, /v1/google-hotels/hotel-prices에 POST해 요금 캘린더를 가져옵니다.

  3. 3. 결과 읽기

    GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 되면 results.items의 행을 읽습니다.

목적지의 호텔 검색

SocQ API 키로 인증하고 목적지를 보냅니다. 반환된 호텔 1개당 0.15크레딧이 차감됩니다.

curl -X POST "https://api.socq.ai/v1/google-hotels/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"hotels in new york","currency":"USD","results_limit":18}'

# Poll GET /v1/tasks/{task_id}
# Read the hotels in results.items

Google Hotels API 주요 활용 사례

목적지 요금 벤치마크

같은 일정에서 도시별 1박 요금을 성급, 평점과 함께 비교합니다.

요금 일관성 점검

같은 숙박에 대해 호텔 공식 요금과 온라인 여행사 요금을 비교합니다.

경쟁 호텔 모니터링

인근 호텔의 요금 캘린더, 평점 분포, 리뷰 주제를 나란히 추적합니다.

여행 콘텐츠와 호텔 페이지

주소, 편의시설, 체크인 시간, 사진, 주변 지역 점수로 호텔 페이지를 채웁니다.

여행 계획

예약 전에 앞으로 몇 주 중 가장 저렴한 체크인 날짜를 찾습니다.

요청 규칙과 비용

다음 규칙은 세 Google Hotels API에 공통으로 적용됩니다.

  • check_in과 check_out은 오늘 이후의 YYYY-MM-DD 날짜로 함께 지정하며 최대 30박까지입니다. 둘 다 생략하면 내일부터 1박 요금이 반환됩니다.
  • currency에 USD, EUR 같은 3자리 코드를 지정하면 요청 간 요금을 비교하기 쉽습니다.
  • Google Hotels API는 요청 1건에 호텔 1~140개(기본 18개)를 반환하며, 반환된 호텔 1개당 0.15크레딧이 차감됩니다.
  • Google Hotel Details API는 검색 결과의 hotel_id를 사용하며 요청 1건에 2크레딧입니다.
  • Hotel Price Tracker API는 hotel_id를 사용하며 캘린더 전체를 요청 1건에 4크레딧으로 반환합니다.

Google Hotels API 자주 묻는 질문

Google Hotels API란 무엇인가요?

Google Hotels API는 목적지로 구글 호텔을 검색해 지정한 일정의 1박 요금, 성급, 투숙객 평점, 리뷰 수, 좌표, 후속 요청에 쓰는 호텔 ID를 반환하는 API입니다.

어떤 Google Hotels API를 사용할 수 있나요?

검색용 Google Hotels API, 호텔 한 곳의 프로필과 예약 사이트별 요금을 반환하는 Google Hotel Details API, 체크인 날짜별 요금을 반환하는 Hotel Price Tracker API입니다.

hotel_id는 어디서 얻나요?

Google Hotels API가 반환하는 각 행의 id 필드에 호텔 ID가 있습니다. 그 값을 hotel_id로 상세 정보 API와 요금 캘린더 API에 넘기면 됩니다.

요금은 어떤 일정 기준인가요?

검색과 상세 정보는 지정한 check_in과 check_out(최대 30박) 기준이며, 둘 다 생략하면 내일부터 1박 요금입니다. 요금 캘린더는 체크인 날짜마다 1박씩 약 6~8주 분량을 담습니다.

Google Hotels 요청 비용은 어떻게 되나요?

검색은 반환된 호텔 1개당 0.15크레딧, 호텔 상세 정보는 요청 1건에 2크레딧, 요금 캘린더는 요청 1건에 4크레딧입니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.

Brand Monitoring API

브랜드, 제품, 주제를 언급한 웹 페이지를 찾아 페이지마다 감성과 감정을 점수로 매기고, 웹 전체에서 어떻게 이야기되는지 요약합니다.

AI Search API

AI 개요, ChatGPT, Google AI 모드가 시장의 질문에 어떻게 답하는지 추적합니다. 브랜드를 언급한 답변, 브랜드의 노출 수준, 답변이 인용한 도메인과 페이지를 알 수 있습니다.

Instagram API

공개 프로필을 조회하거나 찾고, 팔로워 목록 레코드, 팔로잉 관계, 작성 게시물, 프로필이 태그된 게시물, 해시태그 결과, 릴스, 스크립트, 댓글, 계정 수치, 참여도 지표, 미디어 메타데이터를 하나의 비동기 워크플로로 수집합니다.

TikTok API

지원하는 공개 TikTok 프로필, 개별 동영상 메타데이터, 최상위 댓글, 동영상 검색 결과, 지정한 해시태그의 동영상을 하나의 정규화된 비동기 워크플로로 수집합니다.

YouTube API

지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.

Facebook API

공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.