DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
실시간 Google 호텔 정보 고급 조회
호텔 하나의 Google 목록 정보(객실, 편의시설, 가격, Google이 표시하는 예약 옵션)를 반환합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result에, 결과는 tasks[0].status_code에 있으며, 거부된 요청도 여전히 HTTP 200을 반환합니다. 원본 형식은 post_dataforseo_business_google_hotel_info_live_html, 대기열 형식은 post_dataforseo_business_google_hotel_info_submit입니다. 호텔을 먼저 찾으려면 post_dataforseo_business_google_hotel_searches_live를 사용하세요.
가격 참고
- 과금 기준: 응답에 보고된 비용.
- 참고 요청 추정치: USD 0.2428.
- 참고 고객 배수: 1.0. 이미 정산된 고객 금액에는 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격, 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: array (object | null)[]
- adults유형: integer | null
성인 수
선택 필드
이 필드를 지정하지 않으면 기본값으로 성인 2명이 사용됩니다
예:1 - check유형: string | null
_in 체크인 날짜
선택 필드
이 필드를 지정하지 않으면 기본값으로 내일 날짜가 사용됩니다;
값은 오늘 날짜보다 이르면 안 됩니다
날짜 형식:"yyyy-mm-dd"
예:"2019-01-15" - check유형: string | null
_out 체크아웃 날짜
선택 필드
이 필드를 지정하지 않으면 시스템이 기본값으로 이틀 뒤 날짜를 적용합니다;
참고: 값은check_in보다 작거나 같을 수 없습니다;check_in과check_out값 사이의 범위는 30일을 초과할 수 없습니다
날짜 형식:"yyyy-mm-dd"
예:"2019-01-15" - children유형: array string[] | null
아동 수와 나이
선택 필드
이 필드를 지정하지 않으면 검색에 아동이 포함되지 않습니다14세 아동 한 명을 포함하려면 다음 값을 설정하세요:
[14]
13세 아동 한 명과 8세 아동 한 명을 포함하려면 다음 값을 설정하세요:[13,8] - currency유형: string | null
통화
선택 필드
예:"USD" - hotel유형: string
_identifier - language유형: string
_code 검색 엔진 언어 코드
language_name을 지정하지 않으면 필수 필드
이 필드를 사용하면language_name을 지정할 필요가 없습니다
사용 가능한 언어와 해당language_code목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/languages
예:en - language유형: string
_name 검색 엔진 언어의 전체 이름
language_code를 지정하지 않으면 필수 필드
이 필드를 사용하면language_code를 지정할 필요가 없습니다
사용 가능한 언어와 해당language_name목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/languages
예:English - load유형: boolean | null
_prices _by _dates 날짜별 호텔 숙박 가격 로드
선택 필드
이 매개변수를true로 지정하면 응답에 날짜별로 구분된 호텔 숙박 가격이 담긴prices_by_dates배열이 포함됩니다
이 매개변수를 사용하면 요청 기본 가격의 두 배가 청구됩니다 - location유형: integer
_code 검색 엔진 위치 코드
location_name또는location_coordinate를 지정하지 않으면 필수 필드
이 필드를 사용하면location_name또는location_coordinate를 지정할 필요가 없습니다
사용 가능한 위치와 해당location_code목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/locations
예:2840 - location유형: string
_coordinate 위치의 GPS 좌표
location_name또는location_code를 지정하지 않으면 필수 필드
이 필드를 사용하면location_name또는location_code를 지정할 필요가 없습니다location_coordinate매개변수는 "latitude, longitude" 형식으로 지정해야 합니다
"latitude"와 "longitude"의 최대 소수 자릿수: 7
참고: 좌표로 위치를 지정하면 가장 가까운 정착지에서 검색이 수행됩니다;
예:53.476225,-2.243572 - location유형: string
_name 검색 엔진 위치의 전체 이름
location_code또는location_coordinate를 지정하지 않으면 필수 필드
이 필드를 사용하면location_code또는location_coordinate를 지정할 필요가 없습니다
사용 가능한 위치와 해당location_name목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/locations
예:London,England,United Kingdom - prices유형: string | null
_date _range 일별 가격 데이터 조회를 위한 사전 정의 기간
선택 필드
이 매개변수를 사용하려면load_prices_by_dates를true로 지정해야 합니다prices_start_date를 지정하지 않으면 시작일이check_in날짜로 설정됩니다
가능한 값:month,three_months,six_months,year
기본값:month - prices유형: string | null
_end _date 날짜별 가격 로드 종료일
선택 필드
이 매개변수를 사용하려면load_prices_by_dates를true로 지정해야 합니다
이 매개변수를 지정하지 않으면 한 달치 날짜별 가격을 받습니다
날짜 형식:yyyy-mm-dd
예:2025-05-21 - prices유형: string | null
_start _date 날짜별 가격 로드 시작일
선택 필드
이 매개변수를 사용하려면load_prices_by_dates를true로 지정해야 합니다
이 매개변수를 지정하지 않으면 시작일이check_in날짜로 설정됩니다
날짜 형식:yyyy-mm-dd
예:2025-05-20 - tag유형: string | null
사용자 정의 작업 식별자
선택 필드
최대 255자
이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다tag에 지정한 값은 응답의data객체에서 확인할 수 있습니다
- 유형: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo200
- 유형: number | null 형식: doublecost
전체 작업 비용, USD
- 유형: integer | nullstatus
_code 일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: string | nullstatus
_message 일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- 유형: array (object | null)[] | nulltasks
작업 배열
- 유형: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- cost유형: number | null 형식: double
전체 작업 비용, USD
- data유형: object | null
POST 요청에 지정한 것과 동일한 매개변수를 포함합니다
- property유형: object | null
Name
- id유형: string | null
작업 식별자 시스템 내 고유 작업 식별자(UUID 형식)
- path유형: array (string | null)[] | null
URL 경로
- result유형: array (object | null)[] | null
결과 배열
- about유형: object | null · Response36Afe1097B20_HotelAboutInfo
호텔 정보
- amenities유형: array (object | null)[] | null
호텔 편의시설
호텔 편의시설에 관한 정보- category유형: string | null
편의시설의 표준화된 카테고리
- category유형: string | null
_label 카테고리 라벨
- items유형: array (object | null)[] | null
특정 편의시설 및 세부 정보
- amenity유형: string | null
표준화된 편의시설 이름
- amenity유형: string | null
_label 표시되는 편의시설 이름
- hint유형: string | null
편의시설에 대한 표준화된 세부 정보
- hint유형: string | null
_label 편의시설에 대해 표시되는 세부 정보
- is유형: boolean | null
_available 호텔에서
amenity를 사용할 수 있는지 여부를 나타냅니다
- check유형: object | null · Response36Afe1097B20_TimeInfo
_in _time 호텔 체크인 시간
호텔 목록에 표시된 체크인 시간- hour유형: integer | null
24시간 형식의 시
- minute유형: integer | null
분
- check유형: object | null · Response36Afe1097B20_TimeInfo
_out _time 호텔 체크아웃 시간
호텔 목록에 표시된 체크아웃 시간- hour유형: integer | null
24시간 형식의 시
- minute유형: integer | null
분
- description유형: string | null
호텔 설명
결과를 수집하는 호텔 엔터티의 설명 - domain유형: string | null
호텔 도메인
호텔 웹사이트의 도메인 - full유형: string | null
_address 호텔 전체 주소
표준화된 형식으로 표시된 호텔 주소 - popular유형: array (object | null)[] | null
_amenities 호텔 편의시설
"인기"로 표시된 호텔 편의시설에 관한 정보- amenity유형: string | null
표준화된 편의시설 이름
- amenity유형: string | null
_label 표시되는 편의시설 이름
- hint유형: string | null
편의시설에 대한 표준화된 세부 정보
- hint유형: string | null
_label 편의시설에 대해 표시되는 세부 정보
- is유형: boolean | null
_available 호텔에서
amenity를 사용할 수 있는지 여부를 나타냅니다
- sub유형: array (string | null)[] | null
_descriptions 호텔 추가 설명
설명에 추가로 제공되는 호텔 세부 정보 - url유형: string | null
호텔 URL
목록에 표시된 호텔 웹사이트의 URL
- address유형: string | null
호텔 주소
호텔의 실제 주소입니다 - check유형: string | null
_url 검색 엔진 결과로의 직접 URL
이 URL로 우리가 정확한 결과를 제공했는지 확인할 수 있습니다 - datetime유형: string | null
결과를 받은 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00 - hotel유형: string | null
_identifier POST 배열에서 받은 식별자
이 필드에는 작업을 설정할 때 지정한hotel_identifier매개변수가 포함됩니다;
예:CgoI-KWyzenM_MV3EAE - language유형: string | null
_code POST 배열의 언어 코드
- location유형: object | null · Response36Afe1097B20_HotelLocationInfo
호텔 위치 정보
호텔이 위치한 장소에 대한 정보입니다- latitude유형: number | null
호텔 위도
호텔 위치의 위도 좌표
예:39.4806397 - location유형: array (object | null)[] | null
_chain 위치 체인의 요소
위치 체인의 각 요소에 대한 추가 매개변수 - longitude유형: number | null
호텔 경도
호텔 위치의 위도 좌표
예:-106.0512973 - maps유형: string | null
_url Google Maps에서 호텔 위치의 URL
- neighborhood유형: string | null
호텔이 위치한 지역의 이름
- neighborhood유형: string | null
_description 호텔이 위치한 지역에 대한 설명
- overall유형: number | null
_score 호텔 위치의 종합 점수
1에서 5 범위의 호텔 위치 종합 점수를 나타냅니다;
주변 명소 및 레스토랑, 교통, 공항과의 근접성 데이터를 기준으로 계산됩니다;
기준은 종합 점수에서 동일한 가중치로 반영되지 않습니다 - score유형: object | null
_by _categories 호텔 위치의 카테고리 점수
주변 명소, 레스토랑, 교통, 공항과의 근접성을 나타내는 카테고리에 연결된 호텔 위치 점수;- property유형: number | null 형식: double
Name
- location유형: integer | null
_code POST 배열의 위치 코드
- overview유형: array (string | null)[] | null
_images 호텔 개요에 표시되는 이미지
호텔 개요에 표시되는 이미지의 URL을 담은 배열입니다 - phone유형: string | null
호텔 전화번호
호텔의 연락처 전화번호입니다 - prices유형: object | null · Response36Afe1097B20_HotelPriceInfo
호텔 엔터티의 가격 정보
호텔 가격에 대한 정보를 포함합니다- check유형: string | null
_in 체크인 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00 - check유형: string | null
_out 체크아웃 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:2019-11-15 12:57:46 +00:00 - currency유형: string | null
가격 통화
POST 배열에 지정하지 않는 한 기본적으로USD가 적용됩니다 - discount유형: string | null
_text 적용된 할인에 대한 텍스트
- items유형: array (object | null)[] | null
발견된 항목 유형
items배열에서 발견된 검색 엔진 결과 유형;
가능한 항목 유형:hotel_search_item- currency유형: string | null
가격 통화
POST 배열에 지정하지 않는 한 기본적으로USD가 적용됩니다 - domain유형: string | null
타사 도메인 가격 정보가 있는 타사 웹사이트 페이지의 도메인
- free유형: string | null
_cancellation _until 무료 취소가 가능한 마지막 날짜 UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00” 선택한 날짜에 무료 취소가 불가능한 경우 null입니다
- is유형: boolean | null
_paid 유료 호텔 목록 여부
true이면 관련hotel_search_item이 유료 광고입니다false이면 관련hotel_search_item이 유기적 호텔 목록입니다 - offers유형: array (object | null)[] | null
추천 가격 제안
- currency유형: string | null
가격 통화
POST 배열에 지정하지 않는 한 기본적으로USD가 적용됩니다 - free유형: string | null
_cancellation _until 무료 취소가 가능한 마지막 날짜 UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00” 선택한 날짜에 무료 취소가 불가능한 경우 null입니다
- max유형: integer | null
_visitors 최대 방문객 수 가격 제안이 유효한 최대 방문객 수
- offer유형: array (string | null)[] | null
_images 가격 제안 이미지 가격 제안에 포함된 이미지의 URL
- price유형: number | null
1박당 가격
- title유형: string | null
호텔 제목
- type유형: string | null
요소 유형
- url유형: string | null
가격 제안 URL 가격 제안이 표시되는 웹사이트 페이지의 URL
- official유형: boolean | null
_site - price유형: number | null
1박당 가격
- title유형: string | null
호텔 제목
- type유형: string | null
요소 유형
- url유형: string | null
타사 페이지 URL 가격 정보가 있는 타사 웹사이트 페이지의 URL
- price유형: number | null
1박당 가격
- price유형: number | null 형식: int64
_without _discount 할인을 적용하지 않은 1박당 전체 가격
- prices유형: array (object | null)[] | null
_by _dates - check유형: string | null
_in _date - check유형: string | null
_out _date - currency유형: string | null
가격 통화
POST 배열에 지정하지 않는 한 기본적으로USD가 적용됩니다 - price유형: number | null
1박당 가격
- visitors유형: integer | null
이 가격에 해당하는 호텔 방문객 수
- reviews유형: object | null · Response36Afe1097B20_HotelReviewInfo
기준별 호텔 리뷰
호텔 엔터티의 리뷰에 대한 정보입니다- mentions유형: array (object | null)[] | null
호텔 언급
기준별 호텔 리뷰에 관한 정보- negative유형: integer | null 형식: int64
_count 기준별 부정 리뷰 수
- positive유형: integer | null 형식: int64
_count 기준별 긍정 리뷰 수
- positive유형: number | null
_score 기준별 긍정 점수
- title유형: string | null
평가된 기준의 제목
- total유형: integer | null 형식: int64
_count 기준별 전체 리뷰 수
- visible유형: boolean | null
_by _default 요소가 기본적으로 표시됨
리뷰 요소가 기본적으로 표시되는지 나타냅니다
- other유형: array (object | null)[] | null
_sites _reviews 타사 사이트의 리뷰
타사 사이트의 리뷰- rating유형: object | null · Response36Afe1097B20_RatingInfo
리뷰의 평점
타사 사이트의 리뷰에 포함된 평점 정보- rating유형: integer | null
_max rating_type의 최댓값
- rating유형: string | null
_type 평점 유형 여기에서 다음 요소를 확인할 수 있습니다: Max5, Percents, CustomMax
- value유형: number | null 형식: double
평점 값
- votes유형: integer | null 형식: int64
_count 피드백 수
- review유형: string | null
_text 리뷰 텍스트
리뷰 텍스트 - title유형: string | null
리뷰 제목
리뷰가 처음 게재된 타사 사이트의 이름을 포함합니다 - url유형: string | null
리뷰 URL
리뷰가 처음 게재된 타사 사이트의 URL
- rating유형: object | null
_distribution 투표 수 기준 평점 분포
1부터 5까지의 평점 범위에 걸친 투표 수 분포입니다- property유형: integer | null 형식: Int64
Name
- value유형: number | null
고객 투표를 기반으로 한 호텔 종합 평점
- votes유형: integer | null 형식: int64
_count 고객 투표 수
호텔 평점 계산에 포함된 고객 투표 수
- stars유형: integer | null
호텔 등급 평점
1~5성 범위의 등급 평점으로, 호텔 요약에서 리뷰 평점 뒤에 표시됩니다 - stars유형: string | null
_description 호텔 등급 평점
1~5성 범위의 등급 평점으로, 호텔 요약에서 리뷰 평점 뒤에 표시됩니다 - title유형: string | null
호텔 제목
결과를 수집하는 호텔 엔터티의 제목입니다
- result유형: integer | null 형식: int64
_count result 배열의 요소 수
- status유형: integer | null
_code 작업의 상태 코드 DataForSEO가 생성하며 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.
- status유형: string | null
_message 작업의 정보 메시지 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.
- time유형: string | null
실행 시간, 초
- 유형: integer | null 형식: int64tasks
_count tasks 배열의 작업 수
- 유형: integer | null 형식: int64tasks
_error 오류와 함께 반환된 tasks 배열의 작업 수
- 유형: string | nulltime
총 실행 시간(초)
- 유형: string | nullversion
API의 현재 버전
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"hotel_identifier": "CgoI-KWyzenM_MV3EAE"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"hotel_identifier": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"title": null,
"stars": null,
"stars_description": null,
"address": null,
"phone": null,
"about": {
"description": null,
"sub_descriptions": [
"[Max Depth Exceeded]"
],
"check_in_time": "[Max Depth Exceeded]",
"check_out_time": "[Max Depth Exceeded]",
"full_address": null,
"domain": null,
"url": null,
"amenities": [
"[Max Depth Exceeded]"
],
"popular_amenities": [
"[Max Depth Exceeded]"
]
},
"location": {
"neighborhood": null,
"neighborhood_description": null,
"maps_url": null,
"overall_score": null,
"score_by_categories": null,
"latitude": null,
"longitude": null,
"location_chain": [
"[Max Depth Exceeded]"
]
},
"reviews": {
"value": null,
"votes_count": null,
"mentions": [
"[Max Depth Exceeded]"
],
"rating_distribution": null,
"other_sites_reviews": [
"[Max Depth Exceeded]"
]
},
"overview_images": [
null
],
"prices": {
"price": null,
"price_without_discount": null,
"currency": null,
"discount_text": null,
"check_in": null,
"check_out": null,
"visitors": null,
"items": [
"[Max Depth Exceeded]"
],
"prices_by_dates": [
"[Max Depth Exceeded]"
]
}
}
]
}
]
}