Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

إعداد مهام معلومات فندق Google

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

DataForSEO

​

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

DataForSEO العمليات

إعداد مهام معلومات فندق Google

​

يضع استعلام قائمة فندق في قائمة الانتظار، ويعيد معرّف مهمة id. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. استرجع النتيجة محلَّلة عبر get_dataforseo_business_google_hotel_info_fetch أو خامة عبر get_dataforseo_business_google_hotel_info_fetch_html.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.2428 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
application/json
  • النوع: array (object | null)[]
    • adults
      النوع: integer | null

      عدد البالغين
      حقل اختياري
      إذا لم تحدد هذا الحقل، سيُستخدم بالغان افتراضيًا
      مثال:
      1

    • check_in
      النوع: string | null

      تاريخ تسجيل الوصول
      حقل اختياري
      إذا لم تحدد هذا الحقل، سيُستخدم تاريخ الغد افتراضيًا؛
      يجب ألا يكون التاريخ أسبق من تاريخ اليوم
      تنسيق التاريخ: "yyyy-mm-dd"
      مثال:
      "2019-01-15"

    • check_out
      النوع: string | null

      تاريخ تسجيل المغادرة
      حقل اختياري
      إذا لم تحدد هذا الحقل، سيطبّق نظامنا تاريخ يومين من الآن افتراضيًا؛
      ملاحظة: لا يمكن أن تكون القيمة أقل من أو مساوية لـ 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_identifier
      النوع: string

      معرّف فندق فريد
      حقل مطلوب إذا لم تحدد keyword
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد keyword
      معرّف فريد لكيان فندق في بحث Google؛
      يمكنك الحصول على القيمة عبر إرسال طلب إلى Google SERP API المتقدم (مضمّنة في عنصر hotels_pack في الاستجابة)، أو إلى نقطة نهاية Hotel Searches في Business Data API
      مثال:
      ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE

    • keyword
      النوع: string

      الكلمة المفتاحية
      حقل مطلوب إذا لم تحدد hotel_identifier
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد hotel_identifier
      يجب أن تشير الكلمة المفتاحية التي تحددها إلى اسم كيان الفندق
      يمكنك تحديد حتى 700 حرف في حقل keyword
      ستُفكّ جميع ترميزات %## (وسيُفكّ الحرف ‘+’ إلى مسافة)
      إذا كنت بحاجة إلى استخدام الحرف “%” في keyword، فحدده بالشكل “%25”

    • 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

    • load_prices_by_dates
      النوع: boolean | null

      تحميل أسعار الإقامة في الفندق حسب التواريخ
      حقل اختياري
      إذا حددت هذا المعامل بالقيمة true، ستتضمن الاستجابة مصفوفة prices_by_dates بأسعار الإقامة في الفندق مقسّمة حسب التواريخ
      إذا استخدمت هذا المعامل، ستُحتسب عليك ضعف السعر الأساسي للطلب

    • 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

    • 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 بترميز URL؛
      ومنها أن الحرف # سيُرمَّز إلى %23

      اعرف المزيد في مركز المساعدة

    • postback_data
      النوع: string

      نوع بيانات postback_url
      حقل مطلوب إذا حددت postback_url
      يطابق نوع البيانات الذي سيُرسل إلى خادمك
      القيم الممكنة:
      advanced، html

    • 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 بترميز URL؛
      ومنها أن الحرف # سيُرمَّز إلى %23

      اعرف المزيد في مركز المساعدة

    • prices_date_range
      النوع: string | null

      فترة محددة مسبقًا لاسترداد بيانات الأسعار اليومية
      حقل اختياري
      لاستخدام هذا المعامل، يجب تحديد load_prices_by_dates بالقيمة true
      إذا لم يُحدد prices_start_date ، فسيُضبط تاريخ البدء على تاريخ check_in
      القيم الممكنة: month، three_months، six_months، year
      القيمة الافتراضية: month

    • prices_end_date
      النوع: string | null

      تاريخ الانتهاء لتحميل الأسعار حسب التواريخ
      حقل اختياري
      لاستخدام هذا المعامل، يجب تحديد load_prices_by_dates بالقيمة true
      إذا لم يُحدد هذا المعامل، ستحصل على الأسعار حسب التاريخ للشهر
      تنسيق التاريخ: yyyy-mm-dd
      مثال:
      2025-05-21

    • prices_start_date
      النوع: string | null

      تاريخ البدء لتحميل الأسعار حسب التواريخ
      حقل اختياري
      لاستخدام هذا المعامل، يجب تحديد load_prices_by_dates بالقيمة true
      إذا لم يُحدد هذا المعامل، فسيُضبط تاريخ البدء على تاريخ check_in
      تنسيق التاريخ: yyyy-mm-dd
      مثال:
      2025-05-20

    • priority
      النوع: integer | null

      أولوية المهمة
      حقل اختياري
      يمكن أن تأخذ القيم التالية:
      1 – أولوية تنفيذ عادية (تُعيّن افتراضيًا)
      2 – أولوية تنفيذ عالية. ستُحتسب عليك رسوم إضافية للمهام ذات أولوية التنفيذ العالية.
      يمكن حساب التكلفة في صفحة الأسعار.

    • tag
      النوع: string | null

      معرّف مهمة يحدده المستخدم
      حقل اختياري
      الحد الأقصى للأحرف هو 255؛
      يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة؛
      ستجد قيمة tag المحددة في كائن data في الاستجابة

الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostResponseInfo
    • cost
      النوع: number | null التنسيق: double

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • status_code
      النوع: integer | null

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

    • status_message
      النوع: string | null

      رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

    • tasks
      النوع: array (object | null)[] | null

      مصفوفة المهام

      • النوع: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostTaskInfo
        • 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
Request Example for post/v1/beta/dataforseo/business_data/google/hotel_info/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/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",
    "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "advanced"
  }
]'

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

عملية ناجحة

Setting Google Hotel Info Tasks