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

إعداد مهام مراجعات Tripadvisor في بيانات الأعمال

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

DataForSEO

​

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

DataForSEO العمليات

إعداد مهام مراجعات Tripadvisor في بيانات الأعمال

​

يضع مراجعات Tripadvisor لمنشأة واحدة في قائمة الانتظار، ويعيد id للمهمة. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. استرجعها عبر get_dataforseo_business_tripadvisor_reviews_fetch؛ والمكافئ لـ Trustpilot هو post_dataforseo_business_trustpilot_reviews_submit.

مرجع التسعير

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

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

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

      عمق التحليل
      حقل اختياري
      عدد المراجعات في SERP؛
      نوصي بشدة بتعيين عمق التحليل بمضاعفات عشرة، لأن أنظمتنا تعالج عشر مراجعات على التوالي؛
      القيمة الافتراضية: 10؛
      الحد الأقصى: 4490
      ستُحتسب رسوم حسابك لكل SERP يحتوي على ما يصل إلى 10 نتائج؛
      قد يؤدي تعيين عمق أكبر من 10 إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 10 نتائج؛
      يمكن حساب التكلفة في صفحة الأسعار.

    • keyword
      النوع: string

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

    • language_code
      النوع: string | null

      رمز لغة محرك البحث
      حقل اختياري
      إذا استخدمت هذا الحقل، ستُحتسب على حسابك رسوم طلب إضافي واحد
      يمكنك الحصول على قائمة اللغات المتاحة مع language_code عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/tripadvisor/languages
      مثال:
      en
      ستُحتسب عليك رسوم إضافية لتعيين معامل اللغة في نقطة النهاية هذه.
      يمكن حساب التكلفة في صفحة الأسعار.

    • language_name
      النوع: string | null

      الاسم الكامل للغة محرك البحث
      حقل اختياري
      إذا استخدمت هذا الحقل، ستُحتسب على حسابك رسوم طلب إضافي واحد
      يمكنك الحصول على قائمة اللغات المتاحة مع language_name عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/tripadvisor/languages
      مثال:
      English
      ستُحتسب عليك رسوم إضافية لتعيين معامل اللغة في نقطة النهاية هذه.
      يمكن حساب التكلفة في صفحة الأسعار.

    • location_code
      النوع: integer

      رمز موقع محرك البحث
      حقل مطلوب إذا لم تحدد location_name أو url_path
      يمكنك الحصول على قائمة المواقع المتاحة مع location_code عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/tripadvisor/locations
      مثال:
      1003854

    • location_name
      النوع: string

      الاسم الكامل لموقع محرك البحث
      حقل مطلوب إذا لم تحدد location_code أو url_path
      يمكنك الحصول على قائمة المواقع المتاحة مع location_name عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/business_data/tripadvisor/locations
      مثال:
      London,England,United Kingdom

    • months
      النوع: array string[] | null

      التصفية حسب أشهر زيارة المسافر
      حقل اختياري
      القيم الممكنة: january، february، march، april، may، april، june، july، august، september، october، november، december
      يمكنك تحديد عدة قيم دفعةً واحدة

    • 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 – أولوية تنفيذ عالية. ستُحتسب عليك رسوم إضافية للمهام ذات أولوية التنفيذ العالية.
      يمكن حساب التكلفة في صفحة الأسعار.

    • ratings
      النوع: array string[] | null

      تقييم المسافر على Tripadvisor لمكان ذي اهتمام
      حقل اختياري
      تقييم يعتمد على المراجعات المكتوبة من مسافر بعد زيارته لمكان.
      القيم الممكنة: excellent، very_good، average، poor، terrible
      يمكنك تحديد عدة قيم دفعةً واحدة

    • sort_by
      النوع: string | null

      معاملات فرز النتائج
      حقل اختياري
      يمكنك استخدام هذا الحقل لفرز النتائج؛
      أنواع الفرز الممكنة:
      most_recent
      detailed_reviews

    • tag
      النوع: string | null

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

    • translate_reviews
      النوع: boolean | null

      ترجمة المراجعات وفقًا لمسار URL
      حقل اختياري
      إذا ضُبط على true، ستُترجم المراجعات المعادة إلى اللغة المطابقة لـ url_path المحدد؛
      على سبيل المثال، إذا كان url_path يحتوي على tripadvisor.it وكان translate_reviews هو true، فستُترجم المراجعات إلى الإيطالية؛
      القيمة الافتراضية: true
      يمكنك معرفة المزيد عن كيفية ترجمة المراجعات في مقالة مركز المساعدة هذه

    • url_path
      النوع: string

      مسار URL للكيان التجاري
      حقل مطلوب إذا لم تحدد keyword
      مسار URL لصفحة الكيان التجاري على Tripadvisor؛
      أمثلة:
      Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html
      https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html

    • visit_type
      النوع: array string[] | null

      التصفية حسب نوع المسافرين الذين كتبوا مراجعة
      حقل اختياري
      القيم الممكنة: families، couples، solo، business، friends
      يمكنك تحديد عدة قيم دفعةً واحدة

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskPostTaskInfo
        • 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/tripadvisor/reviews/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
    "location_code": 1003854,
    "pingback_url": "https://your-server.com/pingback.php?id=$id&tag=$tag",
    "tag": "some_string_123"
  }
]'

{
  "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 Business Data Tripadvisor Reviews Tasks