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

الحصول على نتائج Google AI Mode SERP المتقدمة حسب id

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

DataForSEO

​

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

الحصول على نتائج Google AI Mode SERP المتقدمة حسب id

​

يسترجع نتيجة Google ai mode في قائمة الانتظار حسب id. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.

مرجع التسعير

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

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

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

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

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_SerpGoogleAiModeTaskGetAdvancedTaskInfo
        • 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

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

            أنواع نتائج البحث في SERP
            تحتوي على أنواع نتائج البحث (items) الموجودة في SERP.
            أنواع العناصر الممكنة:
            ai_overview

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

            العناصر الموجودة في العنصر

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

              العناصر الموجودة في العنصر

              • position
                النوع: string | null

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

              • type
                النوع: string | null

                نوع العنصر

            • markdown
              النوع: string | null

              محتوى العنصر بتنسيق markdown
              نص ai_overview منسّقًا بـ لغة ترميز markdown

            • page
              النوع: integer | null

              صفحة SERP
              صفحة SERP التي يظهر عليها العنصر في الترتيب

            • position
              النوع: string | null

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

            • rank_absolute
              النوع: integer | null

              الترتيب المطلق في SERP
              الموضع المطلق بين جميع العناصر في SERP

            • rank_group
              النوع: integer | null

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

            • rectangle
              النوع: object | null · Response36Afe1097B20_AiModeRectangleInfo

              معاملات المستطيل
              تحتوي على الإحداثيات الديكارتية وأبعاد البكسل لمقتطف النتيجة في SERP
              تساوي null إذا لم يُضبط calculate_rectangles في طلب POST على true

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

                ارتفاع العنصر بالبكسل

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

                عرض العنصر بالبكسل

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

                إحداثي المحور x إحداثي المحور x للزاوية العلوية اليسرى من مقتطف النتيجة، حيث تكون الزاوية العلوية اليسرى للشاشة هي نقطة الأصل

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

                إحداثي المحور y إحداثي المحور y للزاوية العلوية اليسرى من مقتطف النتيجة، حيث تكون الزاوية العلوية اليسرى للشاشة هي نقطة الأصل

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

              مراجع إضافية ذات صلة بالعنصر
              يشمل مراجع لصفحات ويب ربما استُخدمت لإنشاء ai_overview

              • domain
                النوع: string | null

                اسم نطاق المرجع

              • position
                النوع: string | null

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

              • source
                النوع: string | null

                اسم مصدر المرجع أو عنوانه

              • text
                النوع: string | null

                نص المكوّن

              • title
                النوع: string | null

                النص المرئي للرابط

              • type
                النوع: string | null

                نوع العنصر

              • url
                النوع: string | null

                عنوان URL للرابط

            • type
              النوع: string | null

              نوع العنصر

            • xpath
              النوع: string | null

              XPath الخاص بالعنصر

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

            عدد النتائج المعادة في المصفوفة items

          • keyword
            النوع: string | null

            الكلمة المفتاحية المستلمة في مصفوفة POST
            تُعاد الكلمة المفتاحية مع فك ترميز %## (سيُفكّ ترميز الرمز '+' إلى مسافة)

          • language_code
            النوع: string | null

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

          • location_code
            النوع: integer | null

            رمز الموقع في مصفوفة POST

          • refinement_chips
            النوع: object | null · Response36Afe1097B20_RefinementChipsInfo

            شرائح تنقية البحث
            في هذه الحالة، ستكون القيمة null

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

              العناصر التابعة للعنصر

              • domain
                النوع: string | null

                النطاق في SERP

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

                خيارات تحسين البحث الإضافية

                • domain
                  النوع: string | null

                  النطاق في SERP

                • title
                  النوع: string | null

                  عنوان العنصر

                • type
                  النوع: string | null

                  نوع العنصر

                • url
                  النوع: string | null

                  عنوان URL للبحث مع معاملات التنقية

              • title
                النوع: string | null

                عنوان العنصر

              • type
                النوع: string | null

                نوع العنصر

              • url
                النوع: string | null

                عنوان URL للبحث مع معاملات التنقية

            • type
              النوع: string | null

              نوع العنصر

            • xpath
              النوع: string | null

              XPath الخاص بالعنصر

          • se_domain
            النوع: string | null

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

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

            العدد الإجمالي للنتائج في SERP

          • spell
            النوع: object | null · Response36Afe1097B20_SpellInfo

            التصحيح التلقائي لمحرك البحث
            إذا قدّم محرك البحث نتائج لكلمة مفتاحية صُحّحت، فسنحدد الكلمة المفتاحية التي صحّحها محرك البحث ونوع التصحيح التلقائي؛
            في هذه الحالة، ستكون القيمة null

            • keyword
              النوع: string | null

              الكلمة المفتاحية التي تم الحصول عليها نتيجة التصحيح التلقائي لمحرك البحث ستُقدَّم النتائج للكلمة المفتاحية المصححة

            • type
              النوع: string | null

              نوع التصحيح التلقائي القيم الممكنة: did_you_mean, showing_results_for, no_results_found_for, including_results_for ملاحظة: يدعم Yahoo وYandex نوع التصحيح التلقائي التالي فقط: including_results_for

          • type
            النوع: string | 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 get/v1/beta/dataforseo/serp/google/ai_mode/task_get/advanced/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/task_get/advanced/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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "page": null,
              "position": null,
              "xpath": null,
              "markdown": null,
              "items": [
                "[Max Depth Exceeded]"
              ],
              "references": [
                "[Max Depth Exceeded]"
              ],
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Get Google AI Mode SERP Advanced Results by id