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

الحصول على نتائج مراجعات Tripadvisor حسب id

الخادم:https://openapi.felo.ai
مكتبات العملاء

DataForSEO

​

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

الحصول على نتائج مراجعات Tripadvisor حسب id

​

يسترجع مراجعات Tripadvisor المصطفّة لعقار واحد حسب id. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. ⚠️ يتغيّر الحجم مع depth المحدّد عند الإرسال، ولا يمكن تضييقه عند الجلب.

مرجع التسعير

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

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

معاملات المسار
  • id
    النوع: string
    مطلوب

    معرّف المهمة
    معرّف مهمة فريد في نظامنا بصيغة UUID
    يمكنك استخدامه خلال 30 يومًا لطلب نتائج المهمة في أي وقت

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetTaskInfo
        • cost
          النوع: number | null التنسيق: double

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

        • data
          النوع: object | null

          يحتوي على المعاملات نفسها التي حددتها في طلب POST

          • propertyName
            النوع: object | null
        • id
          النوع: string | null

          معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

        • path
          النوع: array (string | null)[] | null

          مسار URL

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

          مصفوفة نتائج

          • check_url
            النوع: string | null

            عنوان 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

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

            • date_of_visit
              النوع: string | null

              تاريخ زيارة المراجع للمنشأة المحلية
              بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00"
              مثال:
              2019-11-15 12:57:46 +00:00

            • language
              النوع: string | null

              لغة نص المراجعة

            • original_language
              النوع: string | null

              لغة نص المراجعة غير المترجم

            • position
              النوع: string | null

              محاذاة المراجعة في SERP
              يمكن أن تأخذ القيم التالية: right

            • rank_absolute
              النوع: integer | null

              الرتبة المطلقة بين جميع المراجعات المدرجة
              الموضع المطلق بين جميع المراجعات في القائمة

            • rank_group
              النوع: integer | null

              الموضع ضمن مجموعة عناصر لها قيم type متطابقة
              تُستبعد مواضع العناصر ذات قيم type المختلفة من rank_group

            • rating
              النوع: object | null · Response36Afe1097B20_RatingInfo

              درجة التقييم المقدَّمة من المراجع

              • rating_max
                النوع: integer | null

                الحد الأقصى لقيمة rating_type

              • rating_type
                النوع: string | null

                نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax

              • value
                النوع: number | null التنسيق: double

                قيمة التقييم

              • votes_count
                النوع: integer | null التنسيق: int64

                مقدار الملاحظات

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

              تحتوي على معلومات حول رد المالك

              • text
                النوع: string | null

                محتوى الرد

              • timestamp
                النوع: string | null

                وقت النشر

              • title
                النوع: string | null

                عنوان الرد

            • review_highlights
              النوع: object | null

              أبرز نقاط المراجعة
              تحتوي على معايير وتقييمات المراجعة المميّزة

            • review_id
              النوع: string | null

              معرّف المراجعة

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

              تحتوي على عناوين URL للصور المستخدمة في المراجعة

              • url
                النوع: string | null

                عنوان URL للصورة المستخدمة في المراجعة

            • review_text
              النوع: string | null

              محتوى المراجعة

            • timestamp
              النوع: string | null

              تاريخ ووقت نشر المراجعة
              بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00"
              مثال:
              2019-11-15 12:57:46 +00:00

            • title
              النوع: string | null

              عنوان المراجعة

            • type
              النوع: string | null

              نوع العنصر

            • url
              النوع: string | null

              عنوان URL للمراجعة

            • user_profile
              النوع: object | null · Response36Afe1097B20_BusinessDataUserProfileInfo

              معلومات من الملف الشخصي للمراجع

              • image_url
                النوع: string | null
              • location
                النوع: string | null
              • name
                النوع: string | null
              • reviews_count
                النوع: integer | null التنسيق: int64

                إجمالي عدد المراجعات التي أرسلها المراجع

              • url
                النوع: string | null
          • items_count
            النوع: integer | null التنسيق: int64

            عدد عناصر المراجعات في مصفوفة النتائج
            يمكنك الحصول على مزيد من النتائج باستخدام المعامل depth عند تعيين مهمة

          • language_code
            النوع: string | null

            رمز اللغة في مصفوفة POST

          • location
            النوع: string | null

            موقع المنشأة المحلية
            عنوان المنشأة المحلية التي تُجمع المراجعات لها

          • rating
            النوع: object | null · Response36Afe1097B20_RatingInfo

            تقييم المنشأة المحلية المقابلة
            معدّل الشعبية المستند إلى المراجعات والمعروض في SERP

            • rating_max
              النوع: integer | null

              الحد الأقصى لقيمة rating_type

            • rating_type
              النوع: string | null

              نوع التقييم هنا يمكنك العثور على العناصر التالية: Max5، Percents، CustomMax

            • value
              النوع: number | null التنسيق: double

              قيمة التقييم

            • votes_count
              النوع: integer | null التنسيق: int64

              مقدار الملاحظات

          • rating_distribution
            النوع: object | null

            توزيع التقييم حسب الأصوات
            توزيع الأصوات عبر التقييم في النطاق من 1 إلى 5

            • propertyName
              النوع: integer | null التنسيق: Int64
          • reviews_count
            النوع: integer | null التنسيق: int64

            العدد الإجمالي للمراجعات

          • se_domain
            النوع: string | null

            نطاق محرك البحث في مصفوفة POST

          • title
            النوع: string | null

            عنوان عنصر «reviews» في SERP
            اسم المنشأة المحلية التي تُجمع المراجعات لها

          • type
            النوع: string | null

            نوع العنصر

          • url_path
            النوع: string | null

            مسار URL المستلم في مصفوفة POST

        • 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 get/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/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": [
        {
          "url_path": null,
          "type": null,
          "se_domain": null,
          "check_url": null,
          "datetime": null,
          "title": null,
          "location": null,
          "reviews_count": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "rating_distribution": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "url": null,
              "rating": "[Max Depth Exceeded]",
              "date_of_visit": null,
              "timestamp": null,
              "review_id": null,
              "title": null,
              "review_text": null,
              "language": null,
              "original_language": null,
              "review_images": [
                "[Max Depth Exceeded]"
              ],
              "user_profile": "[Max Depth Exceeded]",
              "responses": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": null
            }
          ],
          "language_code": null
        }
      ]
    }
  ]
}
Get Business Data Tripadvisor Reviews Results by id