DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
משימות חיפוש Google Hotels בזמן אמת
מחפש ב-Google Hotels נכסים שמתאימים לשאילתה, עם תאריכים ותפוסה. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. כך מוצאים את המלון שה-id שלו דרוש לנקודות הקצה של המידע; post_dataforseo_business_google_hotel_info_live הוא תצוגת הפרטים.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.2428 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: 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סוג: string | null
_in תאריך צ׳ק-אין
שדה אופציונלי
אם לא מציינים את השדה הזה, ייעשה שימוש בתאריך של מחר כברירת מחדל;
תבנית תאריך:"yyyy-mm-dd"
דוגמה:"2019-01-15"
הערה: הערך לא יכול להקדים את תאריך היום - checkסוג: string | null
_out תאריך צ׳ק-אאוט
שדה אופציונלי
אם לא מציינים את השדה הזה, המערכת שלנו תחיל כברירת מחדל את התאריך שבעוד יומיים;
תבנית תאריך:"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סוג: boolean | null
_cancellation מלונות עם ביטול חינם
שדה אופציונלי
הגדירו את השדה הזה ל-trueאם ברצונכם לקבל את רשימת המלונות עם ביטול חינם של הזמנות
ערך ברירת מחדל:false - isסוג: boolean | null
_vacation _rentals חיפוש דירות נופש
שדה אופציונלי
הגדירו את השדה הזה ל-trueאם ברצונכם לקבל את רשימת דירות הנופש במקום מלונות
ערך ברירת מחדל:false - keywordסוג: string | null
מילת מפתח
שדה אופציונלי
מילת המפתח שתציינו משמשת לחיפוש רשימת המלונות;
אם לא משתמשים בשדה הזה, נחזיר את רשימת המלונות שנמצאו במיקום שצוין;
אפשר לציין עד 700 תווים בשדהkeyword
כל ה-%## יפוענחו (והתו ‘+’ יפוענח לרווח)
אם אתם צריכים להשתמש בתו “%” ב-keyword, ציינו אותו כ-“%25”;
הערה: כדי לקבל תוצאות חיפוש מדויקות, שם המיקום מתווסף למילת המפתח באופן אוטומטימידע נוסף על הכללים והמגבלות של השדות
keywordו-keywordsב-DataForSEO APIs במאמר מרכז העזרה הזה - 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 - 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
הערה: כדי לקבל תוצאות חיפוש מדויקות, ה-location_nameשציינתם יתווסף למילת המפתח באופן אוטומטי - maxסוג: integer | null
_price מחיר מקסימלי ללילה
שדה אופציונלי
המטבע של הערך הזה תלוי בשדהcurrency
דוגמה:600 - minסוג: integer | null
_price מחיר מינימלי ללילה
שדה אופציונלי
המטבע של הערך הזה תלוי בשדהcurrency
דוגמה:100 - minסוג: number | null
_rating דירוג מינימלי
שדה אופציונלי
אפשר להשתמש בשדה הזה כדי לציין דירוג אורחים גבוה מערך מסוים
דוגמה:2.5 - searchסוג: boolean | null
_this _area - sortסוג: string | null
_by פרמטרי מיון תוצאות
שדה אופציונלי
אפשר להשתמש בשדה הזה כדי למיין את התוצאות
סוגי מיון אפשריים:relevance– מיון לפי הרלוונטיות הגבוהה ביותרlowest_price– מיון לפי המחיר הנמוך ביותרhighest_rating– מיון לפי הדירוג הגבוה ביותרmost_reviewed– מיון לפי מספר הביקורות הגבוה ביותר
ערך ברירת מחדל:relevance - starsסוג: array string[] | null
כוכבי המלון
שדה אופציונלי
הגדירו את השדה הזה ל-[5]אם ברצונכם לקבל רק את רשימת המלונות עם 5 כוכבים
דוגמה:[3,4,5] - tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש
שדה אופציונלי
מגבלת התווים היא 255
אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
את ערך ה-tagשציינתם תמצאו באובייקטdataשל התגובה
- סוג: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesLiveTaskInfo
- 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
מערך תוצאות
- 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 - itemsסוג: array (object | null)[] | null
סוגי פריטים שנתקלו בהם
סוגי תוצאות מנוע חיפוש שנתקלו בהם במערךitems;
סוגי פריטים אפשריים:hotel_search_item- hotelסוג: string | null
_identifier מזהה ייחודי של ישות מלון בחיפוש Google
דוגמה:CgoI-KWyzenM_MV3EAE - isסוג: boolean | null
_paid מציין רישום מלון בתשלום
אם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סוג: array (string | null)[] | null
_images תמונות מוצגות עבור מלון
- 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 כוכבים - titleסוג: string | null
שם המלון
- typeסוג: string | null
סוג הרכיב
- itemsסוג: integer | null פורמט: int64
_count סוגי פריטים
מספר הפריטים במערךitems - keywordסוג: string | null
מילת מפתח שהתקבלה במערך POST
מילת המפתח מוחזרת עם פענוח %## (התו '+' יפענח לרווח) - languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- 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_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]"
}
]
}
]
}
]
}