Felo API PlatformFelo API Platform
همه endpointهای DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

اطلاعات هتل Google پیشرفته زنده

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

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 استفاده کنید.

مرجع قیمت‌گذاری

  • اندازه‌گیری: هزینه گزارش‌شده پاسخ.
  • برآورد درخواست مرجع: 0.2428 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

بدنه
application/json
  • نوع: array (object | null)[]
    • adults
      نوع: integer | null

      تعداد بزرگسالان
      فیلد اختیاری
      اگر این فیلد را تعیین نکنید، به‌صورت پیش‌فرض دو بزرگسال در نظر گرفته می‌شود
      مثال:
      1

    • check_in
      نوع: string | null

      تاریخ ورود
      فیلد اختیاری
      اگر این فیلد را تعیین نکنید، به‌صورت پیش‌فرض تاریخ فردا در نظر گرفته می‌شود؛
      مقدار نباید پیش از تاریخ امروز باشد
      قالب تاریخ: "yyyy-mm-dd"
      مثال:
      "2019-01-15"

    • check_out
      نوع: string | null

      تاریخ خروج
      فیلد اختیاری
      اگر این فیلد را تعیین نکنید، سیستم ما به‌صورت پیش‌فرض تاریخ دو روز بعد را اعمال می‌کند؛
      توجه: مقدار نمی‌تواند کمتر از 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_identifier
      نوع: string

      شناسه یکتای هتل
      فیلد الزامی
      شناسه یکتای موجودیت هتل در جستجوی Google؛
      می‌توانید مقدار را با ارسال درخواست به Google SERP API پیشرفته (که در عنصر hotels پاسخ قرار دارد) یا به نقطه پایانی Hotel Searches در Business Data API دریافت کنید
      مثال:
      ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE

    • 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

    • load_prices_by_dates
      نوع: boolean | null

      بارگذاری قیمت‌های اقامت هتل بر اساس تاریخ
      فیلد اختیاری
      اگر این پارامتر را با true تعیین کنید، پاسخ شامل آرایه prices_by_dates با قیمت‌های اقامت هتل به تفکیک تاریخ خواهد بود
      اگر از این پارامتر استفاده کنید، دو برابر قیمت پایه برای یک درخواست از شما دریافت می‌شود

    • 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

    • prices_date_range
      نوع: string | null

      بازه از پیش تعیین‌شده برای بازیابی داده‌های قیمت روزانه
      فیلد اختیاری
      برای استفاده از این پارامتر، باید load_prices_by_dates را با true تعیین کنید
      اگر prices_start_date تعیین نشود، تاریخ شروع روی تاریخ check_in تنظیم می‌شود
      مقادیر ممکن: month، three_months، six_months، year
      مقدار پیش‌فرض: month

    • prices_end_date
      نوع: string | null

      تاریخ پایان برای بارگذاری قیمت‌ها بر اساس تاریخ
      فیلد اختیاری
      برای استفاده از این پارامتر، باید load_prices_by_dates را با true تعیین کنید
      اگر این پارامتر تعیین نشود، قیمت‌ها را بر اساس تاریخ برای ماه دریافت می‌کنید
      قالب تاریخ: yyyy-mm-dd
      مثال:
      2025-05-21

    • prices_start_date
      نوع: string | null

      تاریخ شروع برای بارگذاری قیمت‌ها بر اساس تاریخ
      فیلد اختیاری
      برای استفاده از این پارامتر، باید load_prices_by_dates را با true تعیین کنید
      اگر این پارامتر تعیین نشود، تاریخ شروع روی تاریخ check_in تنظیم می‌شود
      قالب تاریخ: yyyy-mm-dd
      مثال:
      2025-05-20

    • tag
      نوع: string | null

      شناسه وظیفه تعریف‌شده توسط کاربر
      فیلد اختیاری
      محدودیت کاراکتر 255 است
      می‌توانید از این پارامتر برای شناسایی وظیفه و تطبیق آن با نتیجه استفاده کنید
      مقدار tag مشخص‌شده را در شیء data پاسخ پیدا می‌کنید

پاسخ‌ها
  • 200
    نوع: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo
    • cost
      نوع: number | null قالب: double

      هزینه کل وظایف، دلار آمریکا

    • status_code
      نوع: integer | null

      کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید

    • status_message
      نوع: string | null

      پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید

    • tasks
      نوع: array (object | null)[] | null

      آرایه‌ای از وظایف

      • نوع: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
        • cost
          نوع: number | null قالب: double

          هزینه کل وظایف، دلار آمریکا

        • data
          نوع: object | null

          همان پارامترهایی را دارد که در درخواست POST تعیین کرده‌اید

          • propertyName
            نوع: object | null
        • 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_label
                نوع: string | null

                برچسب دسته‌بندی

              • items
                نوع: array (object | null)[] | null

                امکانات و جزئیات مشخص

                • amenity
                  نوع: string | null

                  نام استانداردشده امکانات

                • amenity_label
                  نوع: string | null

                  نام نمایشی امکانات

                • hint
                  نوع: string | null

                  جزئیات استانداردشده درباره امکانات

                • hint_label
                  نوع: string | null

                  جزئیات نمایش‌داده‌شده درباره امکانات

                • is_available
                  نوع: boolean | null

                  نشان می‌دهد آیا amenity در هتل موجود است

            • check_in_time
              نوع: object | null · Response36Afe1097B20_TimeInfo

              زمان ورود به هتل
              زمان ورود ذکرشده در فهرست هتل

              • hour
                نوع: integer | null

                ساعت‌ها در قالب 24 ساعته

              • minute
                نوع: integer | null

                دقیقه‌ها

            • check_out_time
              نوع: object | null · Response36Afe1097B20_TimeInfo

              زمان خروج از هتل
              زمان خروج ذکرشده در فهرست هتل

              • hour
                نوع: integer | null

                ساعت‌ها در قالب 24 ساعته

              • minute
                نوع: integer | null

                دقیقه‌ها

            • description
              نوع: string | null

              توضیحات هتل
              توضیحات موجودیت هتلی که نتایج برای آن جمع‌آوری می‌شود

            • domain
              نوع: string | null

              دامنه هتل
              دامنه وب‌سایت هتل

            • full_address
              نوع: string | null

              نشانی کامل هتل
              نشانی هتل ذکرشده در قالب استانداردشده

            • popular_amenities
              نوع: array (object | null)[] | null

              امکانات هتل
              اطلاعاتی درباره امکانات هتل با برچسب "محبوب"

              • amenity
                نوع: string | null

                نام استانداردشده امکانات

              • amenity_label
                نوع: string | null

                نام نمایشی امکانات

              • hint
                نوع: string | null

                جزئیات استانداردشده درباره امکانات

              • hint_label
                نوع: string | null

                جزئیات نمایش‌داده‌شده درباره امکانات

              • is_available
                نوع: boolean | null

                نشان می‌دهد آیا amenity در هتل موجود است

            • sub_descriptions
              نوع: array (string | null)[] | null

              توضیحات تکمیلی هتل
              جزئیاتی درباره هتل که علاوه بر توضیحات ارائه می‌شود

            • url
              نوع: string | null

              نشانی URL هتل
              نشانی URL وب‌سایت هتل ذکرشده در فهرست

          • address
            نوع: string | null

            نشانی هتل
            نشانی فیزیکی هتل

          • check_url
            نوع: string | null

            نشانی URL مستقیم نتایج موتور جستجو
            می‌توانید از آن استفاده کنید تا مطمئن شوید نتایج دقیقی ارائه کرده‌ایم

          • datetime
            نوع: string | null

            تاریخ و زمانی که نتیجه دریافت شده است
            در قالب UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            مثال:
            2019-11-15 12:57:46 +00:00

          • hotel_identifier
            نوع: string | null

            شناسه دریافت‌شده در آرایه POST
            این فیلد شامل پارامتر hotel_identifier مشخص‌شده هنگام تنظیم وظیفه خواهد بود؛
            مثال:
            CgoI-KWyzenM_MV3EAE

          • language_code
            نوع: string | null

            کد زبان در آرایه POST

          • location
            نوع: object | null · Response36Afe1097B20_HotelLocationInfo

            اطلاعات موقعیت هتل
            اطلاعاتی درباره مکانی که هتل در آن قرار دارد

            • latitude
              نوع: number | null

              عرض جغرافیایی هتل
              مختصات عرض جغرافیایی موقعیت هتل
              مثال:
              39.4806397

            • location_chain
              نوع: array (object | null)[] | null

              عناصر زنجیره مکان
              پارامترهای اضافی هر عنصر از زنجیره مکان

              • card_id
                نوع: string | null

                شناسه کارت

              • cid
                نوع: string | null

                شناسه مشتری
                درباره این شناسه در این مقاله مرکز راهنما بیشتر بدانید

              • feature_id
                نوع: string | null

                شناسه ویژگی
                درباره این شناسه در این مقاله مرکز راهنما بیشتر بدانید

              • title
                نوع: string | null

                عنوان عنصر در زنجیره موقعیت

            • longitude
              نوع: number | null

              طول جغرافیایی هتل
              مختصات طول جغرافیایی موقعیت هتل
              مثال:
              -106.0512973

            • maps_url
              نوع: string | null

              نشانی URL موقعیت هتل در google maps

            • neighborhood
              نوع: string | null

              نام محله‌ای که هتل در آن قرار دارد

            • neighborhood_description
              نوع: string | null

              توضیحات محله‌ای که هتل در آن قرار دارد

            • overall_score
              نوع: number | null

              امتیاز کلی موقعیت هتل
              امتیاز کلی موقعیت هتل را در بازه 1 تا 5 نشان می‌دهد؛
              بر اساس داده‌های نزدیکی هتل به جاذبه‌ها و رستوران‌های نزدیک، حمل‌ونقل و فرودگاه‌ها محاسبه می‌شود؛
              توجه داشته باشید که معیارها در امتیاز کلی به‌طور یکسان وزن‌دهی نمی‌شوند

            • score_by_categories
              نوع: object | null

              امتیازهای دسته‌بندی موقعیت هتل
              امتیازهای موقعیت هتل مرتبط با دسته‌بندی‌هایی که نزدیکی به جاذبه‌ها و رستوران‌های نزدیک، حمل‌ونقل و فرودگاه‌ها را نشان می‌دهند؛

              • propertyName
                نوع: number | null قالب: double
          • location_code
            نوع: integer | null

            کد مکان در آرایه POST

          • overview_images
            نوع: array (string | null)[] | null

            تصاویر نمایش‌داده‌شده در نمای کلی هتل
            آرایه‌ای شامل نشانی‌های URL تصاویر نمایش‌داده‌شده در نمای کلی هتل

          • phone
            نوع: string | 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

              ارز قیمت
              USD به‌طور پیش‌فرض اعمال می‌شود، مگر اینکه در آرایه POST مشخص شده باشد

            • discount_text
              نوع: string | null

              متن درباره تخفیف اعمال‌شده

            • items
              نوع: array (object | null)[] | null

              انواع آیتم‌های مواجه‌شده
              انواع نتایج موتور جستجو که در آرایه items با آن‌ها مواجه شده‌اید؛
              انواع آیتم‌های ممکن: hotel_search_item

              • currency
                نوع: string | null

                ارز قیمت
                USD به‌طور پیش‌فرض اعمال می‌شود، مگر اینکه در آرایه POST مشخص شده باشد

              • 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

                  ارز قیمت
                  USD به‌طور پیش‌فرض اعمال می‌شود، مگر اینکه در آرایه POST مشخص شده باشد

                • 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

                  قیمت هر شب

                • title
                  نوع: string | null

                  نام هتل

                • type
                  نوع: string | null

                  نوع عنصر

                • url
                  نوع: string | null

                  نشانی URL پیشنهاد قیمت نشانی URL صفحه وب‌سایتی که پیشنهاد قیمت در آن ظاهر می‌شود

              • official_site
                نوع: boolean | null
              • price
                نوع: number | null

                قیمت هر شب

              • title
                نوع: string | null

                نام هتل

              • type
                نوع: string | null

                نوع عنصر

              • url
                نوع: string | null

                نشانی URL صفحه شخص ثالث نشانی URL صفحه وب‌سایت شخص ثالث با اطلاعات قیمت‌گذاری

            • price
              نوع: number | null

              قیمت هر شب

            • price_without_discount
              نوع: number | null قالب: int64

              قیمت کامل هر شب بدون اعمال تخفیف

            • prices_by_dates
              نوع: array (object | null)[] | null
              • check_in_date
                نوع: string | null
              • check_out_date
                نوع: string | null
              • currency
                نوع: string | null

                ارز قیمت
                USD به‌طور پیش‌فرض اعمال می‌شود، مگر اینکه در آرایه POST مشخص شده باشد

              • price
                نوع: number | null

                قیمت هر شب

            • 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 ستاره است و پس از امتیازهای نظرات در خلاصه هتل نمایش داده می‌شود

          • stars_description
            نوع: string | null

            امتیاز دسته هتل
            امتیاز دسته‌ای که بین 1 تا 5 ستاره است و پس از امتیازهای نظرات در خلاصه هتل نمایش داده می‌شود

          • title
            نوع: string | null

            نام هتل
            نام موجودیت هتل که نتایج برای آن جمع‌آوری می‌شوند

        • 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

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for post/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced
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]"
            ]
          }
        }
      ]
    }
  ]
}
Live Google Hotel Info Advanced