Felo API PlatformFelo API Platform
DataForSEO 전체 엔드포인트
v0.2.0-beta
OpenAPI 3.1.0

실시간 Google 호텔 검색

Felo API Support
MIT
서버:https://openapi.felo.ai
클라이언트 라이브러리
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 작업

실시간 Google 호텔 검색

​

쿼리와 날짜, 투숙 인원에 맞는 숙소를 Google Hotels에서 검색합니다. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result에, 결과는 tasks[0].status_code에 있으며, 거부된 요청도 여전히 HTTP 200을 반환합니다. 정보 엔드포인트에 필요한 호텔 id를 찾는 방법이며, post_dataforseo_business_google_hotel_info_live가 상세 보기입니다.

가격 참고

  • 과금 기준: 응답에 보고된 비용.
  • 참고 요청 추정치: USD 0.2428.
  • 참고 고객 배수: 1.0. 이미 정산된 고객 금액에는 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격, 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

본문
application/json
  • 유형: array (object | null)[]
    • adults
      유형: integer | null

      성인 수
      선택 필드
      이 필드를 지정하지 않으면 기본값 2가 적용됩니다;
      참고: 성인과 아동을 포함해 최대 6명까지 지정할 수 있습니다
      예:
      1

    • amenities
      유형: array string[] | null

      호텔 편의시설
      선택 필드
      이 필드를 사용해 다양한 호텔 편의시설을 지정할 수 있습니다
      예:
      [
      "free_parking",
      "pets_allowed"
      ]

      가능한 값:
      "air_conditioning",<br>"all_inclusive_available",<br>"bar",<br>"free_breakfast",<br>"fitness_center",<br>"kid_friendly",<br>"free_parking",<br>"pets_allowed",<br>"pool",<br>"restaurant",<br>"room_service",<br>"spa",<br>"free_wifi",<br>"parking",<br>"indoor_pool",<br>"outdoor_pool",<br>"wheelchair_accessible",<br>"beach_access"

    • check_in
      유형: string | null

      체크인 날짜
      선택 필드
      이 필드를 지정하지 않으면 기본값으로 내일 날짜가 사용됩니다;
      날짜 형식: "yyyy-mm-dd"
      예:
      "2019-01-15"
      참고: 값은 오늘 날짜보다 앞설 수 없습니다

    • check_out
      유형: string | null

      체크아웃 날짜
      선택 필드
      이 필드를 지정하지 않으면 시스템이 기본값으로 이틀 뒤 날짜를 적용합니다;
      날짜 형식: "yyyy-mm-dd"
      예:
      "2019-01-15"
      참고: 값은 check_in보다 작거나 같을 수 없습니다;
      check_in과 check_out 값 사이의 범위는 30일을 초과할 수 없습니다

    • children
      유형: array string[] | null

      아동 수와 나이
      선택 필드
      이 필드를 지정하지 않으면 검색에 아동이 포함되지 않습니다;
      아동 나이는 0부터 17까지입니다;
      참고: 성인과 아동을 포함해 최대 6명까지 지정할 수 있습니다
      14세 아동 한 명을 포함하려면 다음 값을 설정하세요:
      [14]
      13세 아동 한 명과 8세 아동 한 명을 포함하려면 다음 값을 설정하세요:
      [13,8]

    • currency
      유형: string | null

      통화
      선택 필드
      예:
      "USD"

    • depth
      유형: integer | null

      파싱 깊이
      선택 필드
      Google Hotels의 결과 수
      기본값: 유기적 결과 18개
      최댓값: 140
      참고: 응답의 유료 목록과 관계없이 유기적 결과 18개마다 계정에 요금이 청구됩니다;
      따라서 깊이를 18보다 크게 설정하면 Google Hotels가 18개를 초과하는 결과를 반환할 때 추가 요금이 발생할 수 있습니다;
      지정한 깊이가 응답의 결과 수보다 크면 차액이 계정 잔액으로 자동 환불됩니다

    • free_cancellation
      유형: boolean | null

      무료 취소가 가능한 호텔
      선택 필드
      예약 무료 취소가 가능한 호텔 목록을 받으려면 이 필드를 true로 설정하세요
      기본값: false

    • is_vacation_rentals
      유형: boolean | null

      휴가용 임대 숙소 검색
      선택 필드
      호텔 대신 휴가용 임대 숙소 목록을 받으려면 이 필드를 true로 설정하세요
      기본값: false

    • keyword
      유형: string | null

      키워드
      선택 필드
      지정하는 키워드는 호텔 목록을 검색하는 데 사용됩니다;
      이 필드를 사용하지 않으면 지정한 위치에서 찾은 호텔 목록을 반환합니다;
      keyword 필드에는 최대 700자까지 지정할 수 있습니다
      모든 %##가 디코딩됩니다(‘+’ 문자는 공백 문자로 디코딩됨)
      keyword에 “%” 문자를 사용해야 하는 경우 “%25”로 지정하세요;
      참고: 정확한 검색 결과를 얻으려면 위치 이름이 키워드 뒤에 자동으로 추가됩니다

      DataForSEO API의 keyword 및 keywords 필드 규칙과 제한은 이 Help Center 문서에서 확인하세요

    • language_code
      유형: string

      검색 엔진 언어 코드
      language_name을 지정하지 않으면 필수 필드
      이 필드를 사용하면 language_name을 지정할 필요가 없습니다
      사용 가능한 언어와 해당 language_code 목록은 다음 주소로 별도 요청해 받을 수 있습니다 https://api.dataforseo.com/v3/business_data/google/languages
      예:
      en

    • language_name
      유형: string

      검색 엔진 언어의 전체 이름
      language_code를 지정하지 않으면 필수 필드
      이 필드를 사용하면 language_code를 지정할 필요가 없습니다
      사용 가능한 언어와 해당 language_name 목록은 다음 주소로 별도 요청해 받을 수 있습니다 https://api.dataforseo.com/v3/business_data/google/languages
      예:
      English

    • location_code
      유형: integer

      검색 엔진 위치 코드
      location_name 또는 location_coordinate를 지정하지 않으면 필수 필드
      이 필드를 사용하면 location_name 또는 location_coordinate를 지정할 필요가 없습니다
      사용 가능한 위치와 해당 location_code 목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/locations
      예:
      2840

    • location_coordinate
      유형: string

      위치의 GPS 좌표
      location_name 또는 location_code를 지정하지 않으면 필수 필드
      이 필드를 사용하면 location_name 또는 location_code를 지정할 필요가 없습니다
      location_coordinate 매개변수는 "latitude,longitude" 형식으로 지정해야 합니다
      "latitude"와 "longitude"의 최대 소수 자릿수: 7
      참고: 좌표로 위치를 지정하면 가장 가까운 정착지에서 검색이 수행됩니다
      예:
      53.476225,-2.243572

    • location_name
      유형: string

      검색 엔진 위치의 전체 이름
      location_code 또는 location_coordinate를 지정하지 않으면 필수 필드
      이 필드를 사용하면 location_code 또는 location_coordinate를 지정할 필요가 없습니다
      사용 가능한 위치와 해당 location_name 목록은 다음 주소로 별도 요청해 받을 수 있습니다https://api.dataforseo.com/v3/business_data/google/locations
      예:
      London,England,United Kingdom
      참고: 정확한 검색 결과를 얻으려면 지정한 location_name이 키워드 뒤에 자동으로 추가됩니다

    • max_price
      유형: integer | null

      1박당 최대 가격
      선택 필드
      이 값의 통화는 currency 필드에 따릅니다
      예:
      600

    • min_price
      유형: integer | null

      1박당 최소 가격
      선택 필드
      이 값의 통화는 currency 필드에 따릅니다
      예:
      100

    • min_rating
      유형: number | null

      최소 평점
      선택 필드
      이 필드를 사용해 특정 값보다 높은 게스트 평점을 지정할 수 있습니다
      예:
      2.5

    • search_this_area
      유형: boolean | null

      표시된 영역의 호텔 표시
      선택 필드
      true, false 값을 사용할 수 있습니다
      기본값: true
      false로 설정하면 search_this_area 모드가 꺼집니다
      참고: search_this_area 모드가 꺼져 있으면 검색 시 location_name이 keyword에 추가되지 않습니다
      이 매개변수에 대한 자세한 내용은 Help Center에서 확인하세요

    • sort_by
      유형: string | null

      결과 정렬 매개변수
      선택 필드
      이 필드를 사용해 결과를 정렬할 수 있습니다
      가능한 정렬 유형:
      relevance – 관련성 높은 순으로 정렬
      lowest_price – 최저 가격순으로 정렬
      highest_rating – 최고 평점순으로 정렬
      most_reviewed – 리뷰 많은 순으로 정렬
      기본값: relevance

    • stars
      유형: array string[] | null

      호텔 등급
      선택 필드
      5성급 호텔 목록만 받으려면 이 필드를 [5]로 설정하세요
      예:
      [3,4,5]

    • tag
      유형: string | null

      사용자 정의 작업 식별자
      선택 필드
      최대 255자
      이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다
      tag에 지정한 값은 응답의 data 객체에서 확인할 수 있습니다

응답
  • 200
    유형: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo
    • cost
      유형: number | null 형식: double

      전체 작업 비용, USD

    • status_code
      유형: integer | null

      일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.

    • status_message
      유형: string | null

      일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.

    • tasks
      유형: array (object | null)[] | null

      작업 배열

      • 유형: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveTaskInfo
        • cost
          유형: number | null 형식: double

          전체 작업 비용, USD

        • data
          유형: object | null

          POST 요청에 지정한 것과 동일한 매개변수를 포함합니다

          • propertyName
            유형: object | null
        • id
          유형: string | null

          작업 식별자 시스템 내 고유 작업 식별자(UUID 형식)

        • path
          유형: array (string | null)[] | null

          URL 경로

        • result
          유형: array (object | null)[] | null

          결과 배열

          • check_url
            유형: string | null

            검색 엔진 결과로의 직접 URL
            이 URL로 우리가 정확한 결과를 제공했는지 확인할 수 있습니다

          • datetime
            유형: string | null

            결과를 받은 날짜와 시간
            UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
            예:
            2019-11-15 12:57:46 +00:00

          • items
            유형: array (object | null)[] | null

            발견된 항목 유형
            items 배열에서 발견된 검색 엔진 결과 유형;
            가능한 항목 유형: hotel_search_item

            • hotel_identifier
              유형: string | null

              Google 검색에서 호텔 엔터티의 고유 식별자
              예:
              CgoI-KWyzenM_MV3EAE

            • is_paid
              유형: boolean | null

              유료 호텔 목록 여부
              true이면 관련 hotel_search_item이 유료 광고입니다
              false이면 관련 hotel_search_item이 유기적 호텔 목록입니다

            • location
              유형: object | null · Response36Afe1097B20_GpsCoordinatesLocationInfo

              호텔 위치의 GPS 좌표

              • latitude
                유형: number | null

                Google Maps에서 호텔의 위도 좌표
                예:
                "latitude": 51.584091

              • longitude
                유형: number | null

                Google Maps에서 호텔의 경도 좌표
                예:
                "longitude": -0.31365919999999997

            • overview_images
              유형: array (string | null)[] | null

              호텔 대표 이미지

            • prices
              유형: object | null · Response36Afe1097B20_HotelPriceInfo

              호텔 가격

              • check_in
                유형: string | null

                체크인 날짜와 시간
                UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
                예:
                2019-11-15 12:57:46 +00:00

              • check_out
                유형: string | null

                체크아웃 날짜와 시간
                UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
                예:
                2019-11-15 12:57:46 +00:00

              • currency
                유형: string | null

                가격 통화
                POST 배열에 지정하지 않는 한 기본적으로 USD가 적용됩니다

              • discount_text
                유형: string | null

                적용된 할인에 대한 텍스트

              • items
                유형: array (object | null)[] | null

                발견된 항목 유형
                items 배열에서 발견된 검색 엔진 결과 유형;
                가능한 항목 유형: hotel_search_item

                • currency
                  유형: string | null

                  가격 통화
                  POST 배열에 지정하지 않는 한 기본적으로 USD가 적용됩니다

                • domain
                  유형: string | null

                  타사 도메인 가격 정보가 있는 타사 웹사이트 페이지의 도메인

                • free_cancellation_until
                  유형: string | null

                  무료 취소가 가능한 마지막 날짜 UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00” 선택한 날짜에 무료 취소가 불가능한 경우 null입니다

                • is_paid
                  유형: boolean | null

                  유료 호텔 목록 여부
                  true이면 관련 hotel_search_item이 유료 광고입니다
                  false이면 관련 hotel_search_item이 유기적 호텔 목록입니다

                • offers
                  유형: array (object | null)[] | null

                  추천 가격 제안

                  • currency
                    유형: string | null

                    가격 통화
                    POST 배열에 지정하지 않는 한 기본적으로 USD가 적용됩니다

                  • free_cancellation_until
                    유형: string | null

                    무료 취소가 가능한 마지막 날짜 UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00” 선택한 날짜에 무료 취소가 불가능한 경우 null입니다

                  • max_visitors
                    유형: integer | null

                    최대 방문객 수 가격 제안이 유효한 최대 방문객 수

                  • offer_images
                    유형: array (string | null)[] | null

                    가격 제안 이미지 가격 제안에 포함된 이미지의 URL

                  • price
                    유형: number | null

                    1박당 가격

                  • title
                    유형: string | null

                    호텔 제목

                  • type
                    유형: string | null

                    요소 유형

                  • url
                    유형: string | null

                    가격 제안 URL 가격 제안이 표시되는 웹사이트 페이지의 URL

                • official_site
                  유형: boolean | null
                • price
                  유형: number | null

                  1박당 가격

                • title
                  유형: string | null

                  호텔 제목

                • type
                  유형: string | null

                  요소 유형

                • url
                  유형: string | null

                  타사 페이지 URL 가격 정보가 있는 타사 웹사이트 페이지의 URL

              • price
                유형: number | null

                1박당 가격

              • price_without_discount
                유형: number | null 형식: int64

                할인을 적용하지 않은 1박당 전체 가격

              • prices_by_dates
                유형: array (object | null)[] | null
                • check_in_date
                  유형: string | null
                • check_out_date
                  유형: string | null
                • currency
                  유형: string | null

                  가격 통화
                  POST 배열에 지정하지 않는 한 기본적으로 USD가 적용됩니다

                • price
                  유형: number | null

                  1박당 가격

              • visitors
                유형: integer | null

                이 가격에 해당하는 호텔 방문객 수

            • reviews
              유형: object | null · Response36Afe1097B20_HotelReviewInfo

              호텔 리뷰 및 평점 정보

              • mentions
                유형: array (object | null)[] | null

                호텔 언급
                기준별 호텔 리뷰에 관한 정보

                • negative_count
                  유형: integer | null 형식: int64

                  기준별 부정 리뷰 수

                • positive_count
                  유형: integer | null 형식: int64

                  기준별 긍정 리뷰 수

                • positive_score
                  유형: number | null

                  기준별 긍정 점수

                • title
                  유형: string | null

                  평가된 기준의 제목

                • total_count
                  유형: integer | null 형식: int64

                  기준별 전체 리뷰 수

                • visible_by_default
                  유형: boolean | null

                  요소가 기본적으로 표시됨
                  리뷰 요소가 기본적으로 표시되는지 나타냅니다

              • other_sites_reviews
                유형: array (object | null)[] | null

                타사 사이트의 리뷰
                타사 사이트의 리뷰

                • rating
                  유형: object | null · Response36Afe1097B20_RatingInfo

                  리뷰의 평점
                  타사 사이트의 리뷰에 포함된 평점 정보

                  • rating_max
                    유형: integer | null

                    rating_type의 최댓값

                  • rating_type
                    유형: string | null

                    평점 유형 여기에서 다음 요소를 확인할 수 있습니다: Max5, Percents, CustomMax

                  • value
                    유형: number | null 형식: double

                    평점 값

                  • votes_count
                    유형: integer | null 형식: int64

                    피드백 수

                • review_text
                  유형: string | null

                  리뷰 텍스트
                  리뷰 텍스트

                • title
                  유형: string | null

                  리뷰 제목
                  리뷰가 처음 게재된 타사 사이트의 이름을 포함합니다

                • url
                  유형: string | null

                  리뷰 URL
                  리뷰가 처음 게재된 타사 사이트의 URL

              • rating_distribution
                유형: object | null

                투표 수 기준 평점 분포
                1부터 5까지의 평점 범위에 걸친 투표 수 분포입니다

                • propertyName
                  유형: integer | null 형식: Int64
              • value
                유형: number | null

                고객 투표를 기반으로 한 호텔 종합 평점

              • votes_count
                유형: integer | null 형식: int64

                고객 투표 수
                호텔 평점 계산에 포함된 고객 투표 수

            • stars
              유형: integer | null

              호텔 등급 평점
              1~5성 범위의 등급 평점입니다

            • title
              유형: string | null

              호텔 제목

            • type
              유형: string | null

              요소 유형

          • items_count
            유형: integer | null 형식: int64

            항목 유형
            items 배열의 항목 수입니다

          • keyword
            유형: string | null

            POST 배열에서 수신한 키워드
            키워드는 %##이 디코딩된 상태로 반환됩니다('+' 문자는 공백 문자로 디코딩됨)

          • language_code
            유형: string | null

            POST 배열의 언어 코드

          • location_code
            유형: integer | null

            POST 배열의 위치 코드

        • result_count
          유형: integer | null 형식: int64

          result 배열의 요소 수

        • status_code
          유형: integer | null

          작업의 상태 코드 DataForSEO가 생성하며 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.

        • status_message
          유형: string | null

          작업의 정보 메시지 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.

        • time
          유형: string | null

          실행 시간, 초

    • tasks_count
      유형: integer | null 형식: int64

      tasks 배열의 작업 수

    • tasks_error
      유형: integer | null 형식: int64

      오류와 함께 반환된 tasks 배열의 작업 수

    • time
      유형: string | null

      총 실행 시간(초)

    • version
      유형: string | null

      API의 현재 버전

    application/json
  • 400

    요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

  • 401

    유효한 Felo API 키가 필요합니다.

  • 402

    청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

  • 403

    이 계정에는 이 작업을 수행할 권한이 없습니다.

  • 429

    요청 또는 지출 한도에 도달했습니다.

  • 502

    서비스가 요청을 완료할 수 없습니다.

  • 503

    API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

  • 504

    요청을 처리하는 동안 서비스 시간이 초과되었습니다.

  • default

    오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

    application/json
Request Example for post/v1/beta/dataforseo/business_data/google/hotel_searches/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/live \
  --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",
    "keyword": "cheap hotel",
    "check_in": "2023-06-01",
    "check_out": "2023-06-30",
    "currency": "USD",
    "adults": 2,
    "children": [
      "14"
    ],
    "sort_by": "highest_rating",
    "priority": 2,
    "tag": "example"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "hotel_identifier": null,
              "title": null,
              "stars": null,
              "is_paid": null,
              "location": "[Max Depth Exceeded]",
              "reviews": "[Max Depth Exceeded]",
              "overview_images": [
                "[Max Depth Exceeded]"
              ],
              "prices": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

작업 성공

Live Google Hotel Searches Tasks

도움이 필요하신가요?

  • API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
  • Discord에서 Felo 개발자와 대화해 보세요.
  • 변경 내역을 확인해 보세요.
  • 대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
  • LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.