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 است.
- نوع: array (object | null)[]
- adultsنوع: integer | null
تعداد بزرگسالان
فیلد اختیاری
اگر این فیلد را تعیین نکنید، بهصورت پیشفرض دو بزرگسال در نظر گرفته میشود
مثال: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
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا میکنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیامهای اطلاعاتی عمومی را اینجا پیدا میکنید
- نوع: array (object | null)[] | nulltasks
آرایهای از وظایف
- نوع: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo
- costنوع: number | null قالب: double
هزینه کل وظایف، دلار آمریکا
- 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 مستقیم نتایج موتور جستجو
میتوانید از آن استفاده کنید تا مطمئن شوید نتایج دقیقی ارائه کردهایم - 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 نشانی URL موقعیت هتل در google maps
- 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
ارز قیمت
USDبهطور پیشفرض اعمال میشود، مگر اینکه در آرایه POST مشخص شده باشد - discountنوع: string | null
_text متن درباره تخفیف اعمالشده
- itemsنوع: array (object | null)[] | null
انواع آیتمهای مواجهشده
انواع نتایج موتور جستجو که در آرایهitemsبا آنها مواجه شدهاید؛
انواع آیتمهای ممکن:hotel_search_item- currencyنوع: string | null
ارز قیمت
USDبهطور پیشفرض اعمال میشود، مگر اینکه در آرایه POST مشخص شده باشد - 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
ارز قیمت
USDبهطور پیشفرض اعمال میشود، مگر اینکه در آرایه POST مشخص شده باشد - 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
قیمت هر شب
- titleنوع: string | null
نام هتل
- typeنوع: string | null
نوع عنصر
- urlنوع: string | null
نشانی URL پیشنهاد قیمت نشانی URL صفحه وبسایتی که پیشنهاد قیمت در آن ظاهر میشود
- officialنوع: boolean | null
_site - priceنوع: number | null
قیمت هر شب
- titleنوع: string | null
نام هتل
- typeنوع: string | null
نوع عنصر
- urlنوع: string | null
نشانی URL صفحه شخص ثالث نشانی URL صفحه وبسایت شخص ثالث با اطلاعات قیمتگذاری
- priceنوع: number | null
قیمت هر شب
- priceنوع: number | null قالب: int64
_without _discount قیمت کامل هر شب بدون اعمال تخفیف
- pricesنوع: array (object | null)[] | null
_by _dates - checkنوع: string | null
_in _date - checkنوع: string | null
_out _date - currencyنوع: string | null
ارز قیمت
USDبهطور پیشفرض اعمال میشود، مگر اینکه در آرایه POST مشخص شده باشد - priceنوع: number | null
قیمت هر شب
- 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
یک کلید API معتبر Felo لازم است.
- 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]"
]
}
}
]
}
]
}