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

إعداد مهام ‘DataForSEO 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 العمليات

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

​

حجم بحث مستمد من لوحات Clickstream لا من منصات الإعلان، لقائمة keywords. يبدّل use_clickstream المزيج. يعيد location_code وlanguage_code وuse_clickstream وitems_count وitems. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. غالبًا ما يختلف حجم Clickstream عن post_dataforseo_keywords_gads_search_volume_live، وهذا هو المقصود: أحدهما يقيس ما يُعرض على المعلنين، والآخر ما فعله الناس.

مرجع التسعير

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

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

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

      الكلمات المفتاحية المستهدفة
      حقل مطلوب
      ترميز UTF-8
      الحد الأقصى لعدد الكلمات المفتاحية التي يمكنك تحديدها في هذه المصفوفة: 1000
      ستُحوَّل الكلمات المفتاحية إلى صيغة أحرف صغيرة

      ملاحظة: بعض الرموز والأحرف (مثل رموز UTF والرموز التعبيرية) غير مسموح بها
      لمعرفة المزيد حول الرموز والأحرف التي يمكن استخدامها، راجع هذا المقال

      تعرّف على قواعد وقيود حقلي keyword وkeywords في واجهات DataForSEO API في مقال مركز المساعدة

    • language_code
      النوع: string

      رمز لغة محرك البحث
      حقل مطلوب إذا لم تحدد language_name
      يمكنك الحصول على قائمة اللغات المتاحة مع language_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      مثال:
      en

    • language_name
      النوع: string

      الاسم الكامل للغة محرك البحث
      حقل مطلوب إذا لم تحدد language_code
      يمكنك الحصول على قائمة اللغات المتاحة مع language_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      مثال:
      English

    • location_code
      النوع: integer

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

    • location_name
      النوع: string

      الاسم الكامل لموقع محرك البحث
      حقل مطلوب إذا لم تحدد location_code
      يمكنك الحصول على قائمة المواقع المتاحة مع location_name عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
      مثال:
      United Kingdom

    • tag
      النوع: string | null

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

    • use_clickstream
      النوع: boolean | null

      استخدام بيانات clickstream لتقديم النتائج
      حقل اختياري
      إذا ضُبط على true، فستحصل على قيم حجم البحث من DataForSEO استنادًا إلى بيانات clickstream؛
      إذا ضُبط على false، فستُستخدم بيانات حجم البحث من Bing لحساب حجم البحث في DataForSEO؛
      القيمة الافتراضية: true؛
      ملاحظة: حجم البحث من Bing متاح للمواقع المدرجة في نقطتي نهاية Bing Search Volume History Locations وBing Ads Locations؛ وتُحسب قيم حجم البحث لأي موقع آخر استنادًا إلى بيانات clickstream حتى إذا ضبطت هذا المعامل على false

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

          مصفوفة نتائج

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

            مصفوفة الكلمات المفتاحية
            تحتوي على الكلمات المفتاحية ومعدلات حجم البحث الخاصة بها

            • keyword
              النوع: string | null

              الكلمة المفتاحية المقدمة في طلب POST

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

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

              • month
                النوع: integer | null

                الشهر

              • search_volume
                النوع: integer | null

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

              • year
                النوع: integer | null

                السنة

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

              معدل حجم البحث الحالي لكلمة مفتاحية

          • items_count
            النوع: integer | null

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

          • language_code
            النوع: string | null

            رمز اللغة في طلب POST

            ملاحظة:إذا بدت الكلمة المفتاحية في طلب POST مكتوبة خطأً، فستُعاد البيانات للكلمة المفتاحية المكتوبة بشكل صحيح؛
            نستخدم وظيفة Google Ads API للتحقق من هجاء الكلمات المفتاحية والتحقق منه، اعرف المزيد من هذا الرابط

          • location_code
            النوع: integer | null

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

          • use_clickstream
            النوع: boolean | null

            تشير إلى ما إذا كان المعامل use_clickstream نشطًا
            القيم الممكنة: true، false

        • 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/clickstream_data/dataforseo_search_volume/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/clickstream_data/dataforseo_search_volume/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_code": "en",
    "tag": "test-tag",
    "keywords": [
      "you tube",
      "youtube",
      "youtub"
    ]
  }
]'

{
  "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": [
        {
          "location_code": null,
          "language_code": null,
          "use_clickstream": null,
          "items_count": null,
          "items": [
            {
              "keyword": null,
              "search_volume": null,
              "monthly_searches": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Setting Live ‘DataForSEO Search Volume’ Tasks