v0.2.0-beta

OpenAPI 3.1.0

הגדרת משימות חיפוש Google Hotels

Felo API Support

MIT

שרת

https://openapi.felo.ai

ספריות לקוח

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO פעולות

post/v1/beta/dataforseo/business_data/google/hotel_searches/task_post

הגדרת משימות חיפוש Google Hotels

מכניס לתור חיפוש Google Hotels, ומחזיר id של משימה. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. אחזרו עם get_dataforseo_business_google_hotel_searches_fetch.

מראה תמחור

מדידה: עלות תגובה מדווחת.
אומדן בקשת ייחוס: 0.2428 דולר ארה״ב.
מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

גוף

application/json

סוג: array (object | null)[]
- adults
  סוג: integer | null
  
  מספר מבוגרים
  שדה אופציונלי
  אם לא מציינים את השדה הזה, יוחל ערך ברירת המחדל 2;
  הערה שאפשר לציין עד 6 אנשים, כולל מבוגרים וילדים
  דוגמה:
  1
- amenities
  סוג: array string[] | null
  
  מתקני המלון
  שדה אופציונלי
  אפשר להשתמש בשדה הזה כדי לציין מתקנים שונים של המלון
  דוגמה:
  [ "free_parking", "pets_allowed" ]
  ערכים אפשריים:
  "air_conditioning", "all_inclusive_available", "bar", "free_breakfast", "fitness_center", "kid_friendly", "free_parking", "pets_allowed", "pool", "restaurant", "room_service", "spa", "free_wifi", "parking", "indoor_pool", "outdoor_pool", "wheelchair_accessible", "beach_access"
- check_in
  סוג: string | null
  
  תאריך צ׳ק-אין
  שדה אופציונלי
  אם לא מציינים את השדה הזה, ייעשה שימוש בתאריך של מחר כברירת מחדל;
  תבנית תאריך: "yyyy-mm-dd"
  דוגמה:
  "2019-01-15"
  הערה: הערך לא יכול להקדים את תאריך היום
- check_out
  סוג: string | null
  
  תאריך צ׳ק-אאוט
  שדה אופציונלי
  אם לא מציינים את השדה הזה, המערכת שלנו תחיל כברירת מחדל את התאריך שבעוד יומיים;
  תבנית תאריך: "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_cancellation
  סוג: boolean | null
  
  מלונות עם ביטול חינם
  שדה אופציונלי
  הגדירו את השדה הזה ל-true אם ברצונכם לקבל את רשימת המלונות עם ביטול חינם של הזמנות
  ערך ברירת מחדל: false
- is_vacation_rentals
  סוג: boolean | null
  
  חיפוש דירות נופש
  שדה אופציונלי
  הגדירו את השדה הזה ל-true אם ברצונכם לקבל את רשימת דירות הנופש במקום מלונות
  ערך ברירת מחדל: false
- keyword
  סוג: string | null
  
  מילת מפתח
  שדה אופציונלי
  מילת המפתח שתציינו משמשת לחיפוש רשימת המלונות;
  אם לא משתמשים בשדה הזה, נחזיר את רשימת המלונות שנמצאו במיקום שצוין;
  אפשר לציין עד 700 תווים בשדה keyword
  כל ה-%## יפוענחו (והתו ‘+’ יפוענח לרווח)
  אם אתם צריכים להשתמש בתו “%” ב-keyword, ציינו אותו כ-“%25”;
  הערה: כדי לקבל תוצאות חיפוש מדויקות, שם המיקום מתווסף למילת המפתח באופן אוטומטי
  
  מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO APIs במאמר מרכז העזרה הזה
- language_code
  סוג: string
  
  קוד שפת מנוע החיפוש
  שדה חובה אם לא מציינים language_name
  אם משתמשים בשדה הזה, אין צורך לציין language_name
  אפשר לקבל את רשימת השפות הזמינות עם language_code בבקשה נפרדת אל https://api.dataforseo.com/v3/business_data/google/languages
  דוגמה:
  en
- language_name
  סוג: string
  
  השם המלא של שפת מנוע החיפוש
  שדה חובה אם לא מציינים language_code
  אם משתמשים בשדה הזה, אין צורך לציין language_code
  אפשר לקבל את רשימת השפות הזמינות עם language_name בבקשה נפרדת אל https://api.dataforseo.com/v3/business_data/google/languages
  דוגמה:
  English
- location_code
  סוג: integer
  
  קוד מיקום מנוע החיפוש
  שדה חובה אם לא מציינים location_name או location_coordinate
  אם משתמשים בשדה הזה, אין צורך לציין location_name או location_coordinate
  אפשר לקבל את רשימת המיקומים הזמינים עם location_code בבקשה נפרדת אל https://api.dataforseo.com/v3/business_data/google/locations
  דוגמה:
  2840
- location_coordinate
  סוג: string
  
  קואורדינטות GPS של מיקום
  שדה חובה אם לא מציינים location_name או location_code
  אם משתמשים בשדה הזה, אין צורך לציין location_name או location_code
  יש לציין את הפרמטר location_coordinate בתבנית "latitude,longitude"
  מספר הספרות העשרוניות המרבי עבור "latitude" ו-"longitude": 7
  הערה: אם הקואורדינטות משמשות לקביעת מיקום, החיפוש ייערך ביישוב הקרוב ביותר;
  דוגמה:
  53.476225,-2.243572
- location_name
  סוג: string
  
  השם המלא של מיקום מנוע החיפוש
  שדה חובה אם לא מציינים 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_price
  סוג: integer | null
  
  מחיר מקסימלי ללילה
  שדה אופציונלי
  המטבע של הערך הזה תלוי בשדה currency
  דוגמה:
  600
- min_price
  סוג: integer | null
  
  מחיר מינימלי ללילה
  שדה אופציונלי
  המטבע של הערך הזה תלוי בשדה currency
  דוגמה:
  100
- min_rating
  סוג: number | null
  
  דירוג מינימלי
  שדה אופציונלי
  אפשר להשתמש בשדה הזה כדי לציין דירוג אורחים גבוה מערך מסוים
  דוגמה:
  2.5
- pingback_url
  סוג: string | null
  
  כתובת URL להתראה על השלמת משימה
  שדה אופציונלי
  כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
  דוגמה:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  הערה: תווים מיוחדים ב-pingback_url יקודדו ב-urlencoded;
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- postback_url
  סוג: string | null
  
  כתובת URL לשליחת תוצאות המשימה
  שדה אופציונלי
  כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט gzip אל ה-postback_url שציינתם
  אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה.
  דוגמה:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  הערה: תווים מיוחדים ב-postback_url יקודדו ב-urlencoded;
  לדוגמה, התו # יקודד ל-%23
  
  מידע נוסף במרכז העזרה שלנו
- priority
  סוג: integer | null
  
  עדיפות משימה
  שדה אופציונלי
  יכול לקבל את הערכים הבאים:
  1 – עדיפות ביצוע רגילה (מוגדרת כברירת מחדל)
  2 – עדיפות ביצוע גבוהה. תחויבו בתשלום נוסף עבור משימות בעדיפות ביצוע גבוהה.
  אפשר לחשב את העלות בעמוד התמחור.
- search_this_area
  סוג: boolean | null
  
  הצגת מלונות מהאזור המוצג
  שדה אופציונלי
  יכול לקבל את הערכים: true, false
  ערך ברירת מחדל: true
  אם מוגדר ל-false, מצב search_this_area ייכבה
  הערה: אם מצב search_this_area כבוי, ה-location_name לא יתווסף ל-keyword במהלך החיפוש
  מידע נוסף על הפרמטר הזה במרכז העזרה שלנו
- sort_by
  סוג: string | null
  
  פרמטרי מיון תוצאות
  שדה אופציונלי
  אפשר להשתמש בשדה הזה כדי למיין את התוצאות
  סוגי מיון אפשריים:
  relevance – מיון לפי הרלוונטיות הגבוהה ביותר
  lowest_price – מיון לפי המחיר הנמוך ביותר
  highest_rating – מיון לפי הדירוג הגבוה ביותר
  most_reviewed – מיון לפי מספר הביקורות הגבוה ביותר
  ערך ברירת מחדל: relevance
- stars
  סוג: array string[] | null
  
  כוכבי המלון
  שדה אופציונלי
  הגדירו את השדה הזה ל-[5] אם ברצונכם לקבל רק את רשימת המלונות עם 5 כוכבים
  דוגמה:
  [3,4,5]
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה

תגובות

200
סוג: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
cost
סוג: number | null פורמט: double

סך עלות המשימות, בדולר ארה״ב

status_code
סוג: integer | null

קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

status_message
סוג: string | null

הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

tasks
סוג: array (object | null)[] | null

מערך משימות

סוג: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
cost
סוג: number | null פורמט: double

סך עלות המשימות, בדולר ארה״ב

data
סוג: object | null

מכיל את אותם הפרמטרים שציינתם בבקשת POST

propertyName
סוג: object | null
id
סוג: string | null

מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID

path
סוג: array (string | null)[] | null

נתיב URL

result
סוג: object | null

מערך תוצאות
במקרה זה, הערך יהיה null

result_count
סוג: integer | null פורמט: int64

מספר הפריטים במערך result

status_code
סוג: integer | null

קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

status_message
סוג: string | null

הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

time
סוג: string | null

זמן ביצוע, בשניות

tasks_count
סוג: integer | null פורמט: int64

מספר המשימות במערך tasks

tasks_error
סוג: integer | null פורמט: int64

מספר המשימות במערך tasks שהוחזרו עם שגיאה

time
סוג: string | null

זמן ביצוע כולל, בשניות

version
סוג: string | null

הגרסה הנוכחית של ה-API
application/json
400

לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
401

נדרש מפתח API תקף של Felo.
402

לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
403

החשבון אינו מורשה לבצע את הפעולה הזו.
429

הגעתם למגבלת בקשות או לתקרת הוצאה.
502

השירות לא הצליח להשלים את הבקשה.
503

שירות ה-API או החיוב אינו זמין באופן זמני.
504

השירות פג בזמן הטיפול בבקשה.
default

תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

application/json

post/v1/beta/dataforseo/business_data/google/hotel_searches/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_post \
  --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": null
    }
  ]
}

פעולה מוצלחת

הגדרת משימות חיפוש Google Hotels

אימותRequired

DataForSEO

הגדרת משימות חיפוש Google Hotels

מראה תמחור