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]"
]
}
}
]
}
]
}