DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
קבלת תוצאות חיפוש Google Hotels לפי id
מאחזר חיפוש Google Hotels שנכנס לתור לפי 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_BusinessDataGoogleHotelSearchesTaskGetResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetTaskInfo
- 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
- 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/task_get/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": [
{
"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]"
}
]
}
]
}
]
}