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

الحصول على نتائج ‘Bing Keyword Performance’ حسب id

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

DataForSEO

​

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

الحصول على نتائج ‘Bing Keyword Performance’ حسب id

​

يسترجع مهمة أداء كلمات مفتاحية في Bing موضوعة في قائمة الانتظار حسب id. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. الاستجابة مغلّفة في غلاف 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_KeywordsDataBingKeywordPerformanceTaskGetResponseInfo
    • cost
      النوع: number | null التنسيق: double

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

          مصفوفة نتائج

          • keyword
            النوع: string | null

            الكلمة المفتاحية في مصفوفة POST

          • keyword_kpi
            النوع: object | null · Response36Afe1097B20_KeywordKpi

            كائن يحتوي على مقاييس الكلمة المفتاحية
            إذا لم تكن هناك بيانات، تكون القيمة_nulln

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

              بيانات الكلمات المفتاحية المجمّعة لأجهزة سطح المكتب
              إذا لم تكن هناك بيانات، تكون القيمة_nulln

              • ad_position
                النوع: string | null

                يمثّل موضع الإعلان ذي الصلة في SERP
                يمكن أن يأخذ القيم التالية:
                FirstPage1: أول إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage2: ثاني إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage3: ثالث إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage4: رابع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage5: خامس إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage6: سادس إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage7: سابع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage8: ثامن إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage9: تاسع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage10: عاشر إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                MainLine1: أول إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine2: ثاني إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine3: ثالث إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine4: رابع إعلان يظهر في أعلى صفحة نتائج البحث

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

                متوسط مزايدة الكلمة المفتاحية

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

                متوسط تكلفة النقرة، بالدولار الأمريكي
                يُحتسب بقسمة تكلفة جميع النقرات على عدد النقرات

              • clicks
                النوع: integer | null

                نقرات الإعلان
                عدد النقرات التي ولّدتها الكلمة المفتاحية ونوع المطابقة خلال الشهر الماضي

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

                معدّل النقر كنسبة مئوية
                يُحتسب بقسمة عدد النقرات على عدد الظهور وضرب الناتج في 100

              • impressions
                النوع: integer | null

                ظهور الإعلان
                عدد الظهور التي ولّدتها الكلمة المفتاحية ونوع المطابقة خلال الشهر الماضي

              • total_cost
                النوع: number | null التنسيق: int64

                التكلفة الإجمالية للإعلان، بالدولار الأمريكي
                تكلفة استخدام الكلمة المفتاحية ونوع المطابقة المحددين خلال الشهر الماضي

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

              بيانات الكلمات المفتاحية المجمّعة للأجهزة المحمولة
              إذا لم تكن هناك بيانات، تكون القيمة_nulln

              • ad_position
                النوع: string | null

                يمثّل موضع الإعلان ذي الصلة في SERP
                يمكن أن يأخذ القيم التالية:
                FirstPage1: أول إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage2: ثاني إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage3: ثالث إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage4: رابع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage5: خامس إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage6: سادس إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage7: سابع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage8: ثامن إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage9: تاسع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage10: عاشر إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                MainLine1: أول إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine2: ثاني إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine3: ثالث إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine4: رابع إعلان يظهر في أعلى صفحة نتائج البحث

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

                متوسط مزايدة الكلمة المفتاحية

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

                متوسط تكلفة النقرة، بالدولار الأمريكي
                يُحتسب بقسمة تكلفة جميع النقرات على عدد النقرات

              • clicks
                النوع: integer | null

                نقرات الإعلان
                عدد النقرات التي ولّدتها الكلمة المفتاحية ونوع المطابقة خلال الشهر الماضي

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

                معدّل النقر كنسبة مئوية
                يُحتسب بقسمة عدد النقرات على عدد الظهور وضرب الناتج في 100

              • impressions
                النوع: integer | null

                ظهور الإعلان
                عدد الظهور التي ولّدتها الكلمة المفتاحية ونوع المطابقة خلال الشهر الماضي

              • total_cost
                النوع: number | null التنسيق: int64

                التكلفة الإجمالية للإعلان، بالدولار الأمريكي
                تكلفة استخدام الكلمة المفتاحية ونوع المطابقة المحددين خلال الشهر الماضي

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

              بيانات الكلمات المفتاحية المجمّعة للأجهزة اللوحية
              إذا لم تكن هناك بيانات، تكون القيمة_nulln

              • ad_position
                النوع: string | null

                يمثّل موضع الإعلان ذي الصلة في SERP
                يمكن أن يأخذ القيم التالية:
                FirstPage1: أول إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage2: ثاني إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage3: ثالث إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage4: رابع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage5: خامس إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage6: سادس إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage7: سابع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage8: ثامن إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage9: تاسع إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                FirstPage10: عاشر إعلان يظهر على الجانب الأيمن من صفحة نتائج البحث الأولى
                MainLine1: أول إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine2: ثاني إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine3: ثالث إعلان يظهر في أعلى صفحة نتائج البحث
                MainLine4: رابع إعلان يظهر في أعلى صفحة نتائج البحث

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

                متوسط مزايدة الكلمة المفتاحية

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

                متوسط تكلفة النقرة، بالدولار الأمريكي
                يُحتسب بقسمة تكلفة جميع النقرات على عدد النقرات

              • clicks
                النوع: integer | null

                نقرات الإعلان
                عدد النقرات التي ولّدتها الكلمة المفتاحية ونوع المطابقة خلال الشهر الماضي

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

                معدّل النقر كنسبة مئوية
                يُحتسب بقسمة عدد النقرات على عدد الظهور وضرب الناتج في 100

              • impressions
                النوع: integer | null

                ظهور الإعلان
                عدد الظهور التي ولّدتها الكلمة المفتاحية ونوع المطابقة خلال الشهر الماضي

              • total_cost
                النوع: number | null التنسيق: int64

                التكلفة الإجمالية للإعلان، بالدولار الأمريكي
                تكلفة استخدام الكلمة المفتاحية ونوع المطابقة المحددين خلال الشهر الماضي

          • language_code
            النوع: string | null

            رمز اللغة في مصفوفة POST
            فإذا لم تكن هناك بيانات، تكون القيمة null

          • location_code
            النوع: integer | null

            رمز الموقع في مصفوفة POST
            فإذا لم تكن هناك بيانات، تكون القيمة null

          • month
            النوع: integer | null

            Integer numbers.

          • year
            النوع: integer | null

            تشير إلى السنة التي تُقدَّم البيانات لها
            مثال:
            2020

            _ _ _ _ _ _ monthn

        • 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/keywords_data/bing/keyword_performance/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/keyword_performance/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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "year": null,
          "month": null,
          "keyword_kpi": {
            "desktop": [
              "[Max Depth Exceeded]"
            ],
            "mobile": [
              "[Max Depth Exceeded]"
            ],
            "tablet": [
              "[Max Depth Exceeded]"
            ]
          }
        }
      ]
    }
  ]
}
Get ‘Bing Keyword Performance’ Results by id