دریافت نتایج پیشرفته اطلاعات هتل Google بر اساس id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
دریافت نتایج پیشرفته اطلاعات هتل Google بر اساس id
صفحه هتل صف‌شده را بر اساس id و به‌صورت تجزیه‌شده بازیابی می‌کند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. پاسخ در پاکت DataForSEO قرار می‌گیرد: داده‌ها در tasks[0].result و نتیجه در tasks[0].status_code — درخواست ردشده نیز همچنان HTTP 200 برمی‌گرداند. ⚠️ اندازه پاسخ با depth یا محدودیت تعیین‌شده هنگام ارسال ثابت شده و اینجا قابل محدود کردن نیست؛ اگر بیش از حد بزرگ است، به‌جای صفحه‌بندی دوباره با اندازه کوچک‌تر ارسال کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: هزینه گزارش‌شده پاسخ.
- برآورد درخواست مرجع: 0.012 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo200
- نوع: number | null قالب: doublecost
هزینه کل وظایف، دلار آمریکا
- نوع: integer | nullstatus
_code کد وضعیت عمومی فهرست کامل کدهای پاسخ را اینجا پیدا می‌کنید
- نوع: string | nullstatus
_message پیام اطلاعاتی عمومی فهرست کامل پیام‌های اطلاعاتی عمومی را اینجا پیدا می‌کنید
- نوع: array (object | null)[] | nulltasks
آرایه‌ای از وظایف
- نوع: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskGetAdvancedTaskInfo
- 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 شناسه یکتای هتل
این فیلد شامل پارامتر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/task_get/advanced/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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]"
]
}
}
]
}
]
}