Google Hotels호텔 요금여행 데이터요금 비교API 가이드

Google Hotels API: 호텔 검색, 호텔 상세 정보, 1박 요금 캘린더

SocQ Google Hotels 신규 엔드포인트 3개로 요금이 포함된 호텔 검색 결과, 예약 사이트별 요금이 담긴 호텔 상세 정보, 체크인 날짜별 호텔 최저 1박 요금을 가져옵니다.

SocQ2026년 11월 19일 업데이트약 7분 소요

Google Hotels는 여행지의 성급, 투숙객 평점, 1박 요금, 예약 사이트별 요금을 한 페이지에 보여 줍니다. 여행 서비스, 요금 비교 도구, 레비뉴 매니저에게 필요한 것은 이 데이터를 행으로 받는 것입니다. 비교할 호텔 목록, 숙소 하나의 전체 레코드, 그리고 날짜에 따른 요금 변화가 그것입니다.

2026-11-17 SocQ는 바로 이 작업을 하는 엔드포인트 3개로 Google Hotels 플랫폼을 출시했습니다. 세 엔드포인트는 호텔 id라는 필드 하나로 이어집니다. 이 가이드에서는 각 엔드포인트의 반환 내용, 요청, 가격, 활용 시점을 다룹니다.

빠른 답변: POST /v1/google-hotels/search로 여행지를 검색하고 각 호텔의 id를 보관하세요. 이 값을 hotel_id로 POST /v1/google-hotels/hotel-details에 보내면 편의시설, 리뷰 주제, 예약 사이트별 요금을, POST /v1/google-hotels/hotel-prices에 보내면 체크인 날짜별 최저 1박 요금을 받습니다. 결과는 GET /v1/tasks/{task_id}를 폴링해 가져옵니다.

신규 Google Hotels 엔드포인트

1 SocQ 크레딧 = $0.005입니다.

엔드포인트반환 내용가격
Google Hotels API여행지의 호텔과 성급, 투숙객 평점, 리뷰 수, 지정한 날짜의 최저 1박 요금, 위치, 사진, 호텔 id호텔 1개당 0.15 크레딧($0.00075)
Google Hotel Details API호텔 1개의 주소, 전화번호, 웹사이트, 편의시설, 위치 점수, 평점 분포, 리뷰 주제, 다른 사이트의 평점, 예약 사이트별 요금호출 1회당 2 크레딧($0.01)
Hotel Price Tracker API체크인 날짜마다 1행씩 담긴 호텔의 최저 1박 요금(보통 6~8주 분량의 날짜)호출 1회당 4 크레딧($0.02)

인증과 비동기 작업 흐름

모든 SocQ 요청은 API 키로 인증하며, 제출, 작업 상태 조회, 결과 조회 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 응답에는 data.task_id와 data.status가 담겨 있습니다. 이 ID로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded가 되면 응답의 data.results.items에 정규화 레코드의 첫 페이지가 담깁니다. limit의 기본값은 50이고 최대 500입니다. has_more가 true이면 results.next_cursor를 cursor로 전달해 다음 페이지를 읽으세요. 작업이 queued, running, failed 상태일 때는 results 없이 작업 메타데이터만 반환됩니다.

제출 본문에 선택 사항인 callback_url을 넣으면 작업이 끝났을 때 SocQ가 작업 요약을 담은 POST를 한 번 보냅니다. 레코드는 GET /v1/tasks/{task_id}로 읽으세요. 클라이언트 측 타임아웃이 작업을 취소하지는 않으므로, 중복으로 비용을 내지 말고 같은 작업 ID로 조회를 이어가세요. 402는 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

Google Hotels API: 여행지 검색하기

Google Hotels API는 여행자가 Google에서 검색하는 방식 그대로 호텔을 검색합니다. query에 여행지나 호텔 검색어를 넣으세요.

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
  }'

선택 필드:

  • check_in과 check_out(YYYY-MM-DD, 함께 지정, 최대 30박)으로 특정 숙박 기간의 요금을 조회합니다. 지정하지 않으면 내일부터 1박 요금이 표시됩니다.
  • currency: USD, EUR 같은 세 글자 코드.
  • sort_by: relevance, lowest_price, highest_rating, most_reviewed 중 하나.
  • min_price와 max_price: 선택한 통화 기준 1박 요금 범위.
  • location_code(기본값 2840, 미국)와 language_code(기본값 en).
  • results_limit: 1~140, 기본값 18.

각 호텔 행에는 id, name, stars(15), rating(15), reviews_count, price(amount, currency, formatted), 요금이 적용되는 check_in과 check_out, is_sponsored, 위도와 경도가 담긴 location, images, 그리고 결과 내 rank가 있습니다. 기본값인 호텔 18개는 2.7 크레딧($0.0135), 최대치인 140개는 21 크레딧($0.105)입니다. 문서: Google Hotels search.

Google Hotel Details API: 숙소 하나의 모든 정보

Google Hotel Details API는 Google Hotels가 보유한 숙소 정보를 행 하나로 반환합니다. 검색 결과의 id를 hotel_id로 전달하세요. check_in과 check_out을 추가하면 해당 날짜의 요금을 받고, 그렇지 않으면 내일부터 1박 요금을 받습니다.

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"
  }'

상세 행에는 검색 필드에 더해 다음 항목이 채워집니다.

  • address, phone, website, check_in_time, check_out_time, amenities.
  • overall, things_to_do, restaurants, transit, airport_access에 대한 1~5점의 location_scores.
  • 별점별 리뷰 비율인 rating_distribution.
  • 위치나 조식 같은 review_topics와 각 주제의 긍정·부정·전체 언급 수.
  • 다른 리뷰 사이트에서의 호텔 평점과 리뷰 수인 other_reviews.
  • 예약 사이트마다 하나씩 담긴 offers와 각각의 seller, price, 예약 url, is_official, is_sponsored, free_cancellation_until.

offers는 요금 패리티 점검에 필요한 데이터입니다. 같은 날짜 기준으로 공식 요금과 온라인 여행사(OTA) 요금을 비교하세요. 요청 1회당 2 크레딧($0.01)이 듭니다. 알 수 없는 hotel_id는 행을 반환하지 않지만 과금됩니다. 문서: Google Hotel Details.

Hotel Price Tracker API: 체크인 날짜별 최저 요금

Hotel Price Tracker API는 Google Hotels 날짜 선택기 뒤에 있는 요금 캘린더를 행으로 반환합니다. 호텔 하나에 대해 체크인 날짜별 최저 요금을 받으며, 보통 지정한 체크인부터 6~8주 분량의 날짜가 포함됩니다.

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"
  }'

check_in은 캘린더의 첫 날짜를 정하며(생략하면 내일), check_out과 함께 지정합니다. 각 행에는 호텔 ID와 날짜로 구성된 id, hotel_id, name, check_in, check_out, price가 있습니다. 가장 저렴한 숙박일을 찾거나, 주말과 평일 요금을 차트로 비교하거나, 요금 비교 보고서에 활용하세요. 요청 1회당 날짜 수와 관계없이 4 크레딧($0.02)입니다. 문서: Hotel Price Tracker.

간단한 경쟁 호텔군 분석 워크플로

  1. sort_by: "most_reviewed"로 여행지를 한 번 검색하고 결과에서 경쟁 호텔군을 고릅니다.
  2. 호텔마다 Hotel Details를 가져와 편의시설, 위치 점수, 리뷰 주제, 예약 사이트별 요금을 비교합니다.
  3. 호텔마다 Hotel Price Tracker를 정기적으로 실행하고 모든 행을 collected_at과 함께 저장합니다.

기본 18개 호텔 검색에서 고른 10개 호텔이라면 1회 실행에 검색 2.7 크레딧, 상세 정보 20 크레딧, 요금 캘린더 40 크레딧이 들어 총 62.7 크레딧, 약 $0.31입니다. 요금은 변하므로 각 실행 결과는 스냅샷으로 다루세요. Google Maps의 장소와 리뷰 같은 로컬 비즈니스 데이터는 Google Maps 스크래퍼 API를 참고하세요.

자주 묻는 질문(FAQ)

Google Hotels API란 무엇인가요?

Google Hotels 데이터를 구조화된 행으로 반환하는 SocQ 엔드포인트 모음입니다. 여행지 검색 결과, 호텔 하나의 전체 상세 정보, 1박 요금 캘린더를 제공합니다. Google의 공식 제품이 아니라 SocQ 엔드포인트입니다.

hotel_id는 어디서 얻나요?

Google Hotels 검색 결과의 id 필드에서 얻습니다. 같은 값을 Hotel Details와 Hotel Price Tracker에 사용할 수 있습니다.

요금은 어떤 날짜 기준인가요?

check_in과 check_out(YYYY-MM-DD, 최대 30박)을 보내면 해당 숙박 기간의 요금입니다. 보내지 않으면 검색과 상세 정보는 내일부터 1박 요금을 표시하고, 요금 추적기는 내일부터 캘린더를 시작합니다.

다른 통화로 요금을 받을 수 있나요?

네. EUR 같은 세 글자 currency를 보내세요. 모든 요금 객체에는 amount, currency, 그리고 USD 176 같은 formatted 문자열이 포함됩니다.

잘못된 hotel_id도 과금되나요?

네. Hotel Details는 알 수 없는 hotel_id에 대해 행을 반환하지 않지만 2 크레딧이 과금되므로, 먼저 최근 검색 결과로 ID를 검증하세요.

GOOGLE HOTELS API

공개 Google Hotels URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

Google Hotels API 살펴보기