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

إعداد مهام ‘Search Volume’ المباشرة

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

DataForSEO

​

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

DataForSEO العمليات

إعداد مهام ‘Search Volume’ المباشرة

​

حجم البحث في Bing لقائمة keywords. يعيد keyword وlocation_code وlanguage_code وsearch_partners وdevice وcompetition وcpc وsearch_volume وcategories وmonthly_searches — لاحظ categories التي لا يعيدها مكافئ Google، وغياب competition_index. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. النظير في Google هو post_dataforseo_keywords_gads_search_volume_live؛ شغّل كليهما عندما لا يكون الجمهور على Google وحده. تؤدي نظيرتا الإرسال والجلب لهذه النقطة العمل نفسه بشكل غير متزامن، وبالسعر نفسه، للدفعات الأكبر من أن يُنتظر عليها.

مرجع التسعير

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

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

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

      تاريخ بداية النطاق الزمني
      حقل اختياري
      الحد الأدنى للقيمة: 24 شهرًا من تاريخ اليوم؛
      إذا لم تحدد هذا الحقل، فستُقدَّم بيانات آخر 12 شهرًا؛
      الحد الأدنى للقيمة: سنتان قبل تاريخ اليوم؛
      إذا أعادت نقطة نهاية الحالة القيمة false في الحقل actual_data، فيمكن ضبط date_from على الشهر قبل الماضي وما قبله؛
      إذا أعادت نقطة نهاية الحالة القيمة true في الحقل actual_data، فيمكن ضبط date_from على الشهر الماضي وما قبله؛
      تنسيق التاريخ: "yyyy-mm-dd"
      مثال:
      "2020-01-01"ملاحظة: لا نوصي باستخدام نطاق زمني مخصص لتواريخ العام الماضي

    • date_to
      النوع: string | null

      تاريخ نهاية النطاق الزمني
      حقل اختياري
      إذا لم تحدد هذا الحقل، فستُقدَّم بيانات آخر 12 شهرًا؛
      الحد الأدنى للقيمة: سنتان قبل تاريخ اليوم؛
      الحد الأقصى للقيمة: شهر واحد من تاريخ اليوم؛
      ملاحظة: لا نوصي باستخدام نطاق زمني مخصص لتواريخ العام الماضي؛
      تنسيق التاريخ: "yyyy-mm-dd"
      مثال:
      "2020-03-15"ملاحظة: لا نوصي باستخدام نطاق زمني مخصص لتواريخ العام الماضي

    • device
      النوع: string | null

      نوع الجهاز
      حقل اختياري
      حدد هذا الحقل إذا أردت الحصول على البيانات لنوع جهاز معين؛
      القيم الممكنة: all، mobile، desktop، tablet
      القيمة الافتراضية: all

    • keywords
      النوع: array string[]

      الكلمات المفتاحية
      حقل مطلوب
      الحد الأقصى لعدد الكلمات المفتاحية التي يمكنك تحديدها: 1000
      الحد الأقصى لعدد الأحرف في كل كلمة مفتاحية: 100
      ستُحوَّل الكلمات المفتاحية المحددة إلى أحرف صغيرة، وستُقدَّم البيانات في مصفوفة منفصلة. تعرّف على قواعد وقيود حقلي keyword وkeywords في واجهات DataForSEO API في مقال مركز المساعدة

    • language_code
      النوع: string

      رمز لغة محرك البحث
      حقل مطلوب إذا لم تحدد language_name
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name
      اللغات المدعومة:
      en، fr، de

    • language_name
      النوع: string

      الاسم الكامل للغة محرك البحث
      حقل مطلوب إذا لم تحدد language_code
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code
      اللغات المدعومة:
      English، French، German

    • location_code
      النوع: integer

      رمز موقع محرك البحث
      حقل مطلوب إذا لم تحدد location_name أو location_coordinate
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name أو location_coordinate
      يمكنك الحصول على قائمة مواقع محركات البحث المتاحة مع location_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/bing/locations
      مثال:
      2840

    • location_coordinate
      النوع: string

      إحداثيات GPS لموقع
      حقل مطلوب إذا لم تحدد location_name أو location_code
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name أو location_code
      يجب تحديد المعامل location_coordinate بتنسيق "latitude,longitude"
      ستُقدَّم البيانات للبلد الذي تنتمي إليه الإحداثيات المحددة
      مثال:
      52.6178549,-155.352142

    • location_name
      النوع: string

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

    • search_partners
      النوع: boolean | null

      نوع شركاء بحث Bing
      حقل اختياري
      إذا حددت true، فستُقدَّم النتائج لشبكات مملوكة ومدارة وموزَّعة عبر Bing وYahoo وAOL والمواقع الشريكة التي تستضيف بحث Bing وAOL وYahoo.
      القيمة الافتراضية: false — تُعاد النتائج لشبكات بحث Bing وAOL وYahoo

    • sort_by
      النوع: string | null

      معاملات ترتيب النتائج
      حقل اختياري
      استخدم هذه المعاملات لترتيب النتائج حسب search_volume أو cpc أو competition أو relevance بترتيب تنازلي
      القيمة الافتراضية: relevance

    • tag
      النوع: string | null

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

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

          مصفوفة نتائج

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

            فئات المنتجات والخدمات
            لا يعيد API الخاص بنا فئات لنقطة النهاية هذه: سيساوي المعامل دائمًا null

          • competition
            النوع: number | null

            المنافسة
            تمثّل مقدار المنافسة النسبي المرتبط بالكلمة المفتاحية المحددة في SERP المدفوعة فقط. تستند هذه القيمة إلى بيانات Bing Ads.
            القيم الممكنة: 0.1، 0.5،0.90.1 - منافسة منخفضة،
            0.5 - منافسة متوسطة،
            0.9 - منافسة مرتفعة؛
            إذا لم تكن هناك بيانات، تكون القيمة null

          • cpc
            النوع: number | null

            تكلفة النقرة
            تمثّل متوسط تكلفة النقرة (بالدولار الأمريكي) المدفوعة تاريخيًا مقابل الكلمة المفتاحية.
            إذا لم تكن هناك بيانات، تكون القيمة_nulln

          • device
            النوع: string | null

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

          • keyword
            النوع: string | null

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

          • language_code
            النوع: string | null

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

          • location_code
            النوع: integer | null

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

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

            عمليات البحث الشهرية
            تمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية هذه (كما هو متاح للأشهر الاثني عشر الماضية)، موجّهة إلى المواقع الجغرافية المحددة
            إذا لم تكن هناك بيانات، تكون القيمة_nulln

            • month
              النوع: integer | null

              الشهر

            • search_volume
              النوع: integer | null

              متوسط معدل حجم البحث الشهري

            • year
              النوع: integer | null

              السنة

          • search_partners
            النوع: boolean | null

            تشير إلى ما إذا كانت بيانات شبكات الشركاء مضمنة في الاستجابة

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

            متوسط معدل حجم البحث الشهري
            يمثّل العدد (التقريبي) لعمليات البحث عن فكرة الكلمة المفتاحية المحددة على محرك بحث bing وفقًا لاستهداف المستخدم؛
            يُقرَّب حجم البحث إلى أقرب عشرات؛
            إذا لم تكن هناك بيانات، تكون القيمة_nulln

        • 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/keywords_data/bing/search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_name": "United States",
    "language_code": "en",
    "keywords": [
      "tom and jerry",
      "silicon valley",
      "spider man"
    ]
  }
]'

{
  "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,
          "search_partners": null,
          "device": null,
          "competition": null,
          "cpc": null,
          "search_volume": null,
          "categories": [
            null
          ],
          "monthly_searches": [
            {
              "year": null,
              "month": null,
              "search_volume": null
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Setting Live ‘Search Volume’ Tasks