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

إعداد مهام ‘DataForSEO Trends Subregion Interests’ المباشرة

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

DataForSEO

​

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

DataForSEO العمليات

إعداد مهام ‘DataForSEO Trends Subregion Interests’ المباشرة

​

أين يتركّز الاهتمام بكلمة مفتاحية، موزّعًا على المناطق الفرعية داخل location_code. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. لمعرفة «مَن» بدل «أين»، استخدم post_dataforseo_keywords_trends_demography_live.

مرجع التسعير

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

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

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

      تاريخ بداية النطاق الزمني
      حقل اختياري
      إذا لم تحدد هذا الحقل، فسيُستخدم اليوم والشهر الحاليان من العام السابق افتراضيًا
      الحد الأدنى للقيمة لنوع web: 2004-01-01
      الحد الأدنى للقيمة للأنواع الأخرى: 2008-01-01
      تنسيق التاريخ: "yyyy-mm-dd"
      مثال:
      "2019-01-15"

    • date_to
      النوع: string | null

      تاريخ نهاية النطاق الزمني
      حقل اختياري
      إذا لم تحدد هذا الحقل، فسيُستخدم تاريخ اليوم افتراضيًا
      تنسيق التاريخ: "yyyy-mm-dd"
      مثال:
      "2019-01-15"

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

      الكلمات المفتاحية
      حقل مطلوب
      الحد الأقصى لعدد الكلمات المفتاحية التي يمكنك تحديدها: 5
      تجنّب الرموز والأحرف الخاصة (مثل رموز UTF والرموز التعبيرية)؛
      عند تحديد أحرف غير لاتينية، ستحصل على بيانات للبلدان التي تُستخدم فيها

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

    • location_code
      النوع: integer | null

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

    • location_name
      النوع: string | null

      الاسم الكامل لموقع محرك البحث
      حقل اختياري
      إذا لم تستخدم هذا الحقل، فستتلقى نتائج عالمية
      إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_code
      يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع location_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      لاحظ أن البيانات ستُقدَّم للبلد الذي ينتمي إليه location_name المحدد؛
      مثال:
      United Kingdom

    • tag
      النوع: string | null

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

    • time_range
      النوع: string | null

      النطاقات الزمنية الجاهزة
      حقل اختياري
      إذا حددت المعاملين date_from أو date_to، فسيُتجاهل هذا الحقل عند إعداد المهمة
      القيم الممكنة لجميع معاملات type:
      past_4_hours، past_day، past_7_days، past_30_days، past_90_days، past_12_months، past_5_years

    • type
      النوع: string | null

      نوع العنصر

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

          مصفوفة نتائج

          • 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

            تحتوي على شعبية الكلمة المفتاحية والبيانات ذات الصلة

            • النوع: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                • النوع: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                  • type
                    المميّز
                    النوع: string | null

                    نوع العنصر

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

                    بيانات شعبية الكلمات المفتاحية دون الإقليمية لكل مصطلح محدد

                    • keyword
                      النوع: string | null

                      الكلمة المفتاحية ذات الصلة
                      تستند البيانات المضمّنة في عنصر values إلى هذه الكلمة المفتاحية

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

                      تحتوي على بيانات حول الشعبية النسبية للكلمات المفتاحية حسب البلد أو المنطقة

                      • geo_id
                        النوع: string | null

                        معرّف الموقع
                        يمكنك استخدام هذا الحقل لمطابقة النتائج التي حصلت عليها مع معاملات الموقع المحددة في الطلب
                        راجع القائمة الكاملة للمواقع المتاحة مع geo_id الخاص بها هنا أو عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        مثال:
                        US-NY

                      • geo_name
                        النوع: string | null

                        اسم الموقع
                        يمكنك استخدام هذا الحقل لمطابقة النتائج التي حصلت عليها مع معاملات الموقع المحددة في الطلب
                        راجع القائمة الكاملة للمواقع المتاحة مع geo_name الخاص بها هنا أو عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        مثال:
                        Andorra

                      • value
                        النوع: integer | null

                        معدل شعبية الكلمة المفتاحية النسبي في موقع معيّن
                        يمثّل معدل شعبية الكلمة المفتاحية الخاص بالموقع خلال النطاق الزمني المحدد
                        باستخدام هذه value، يمكنك فهم مدى شعبية كلمة مفتاحية في موقع مقارنةً بموقع آخر
                        الحساب: نحدد أعلى قيمة شعبية للكلمة المفتاحية ذات الصلة عبر جميع المواقع، ثم نعبّر عن جميع القيم الأخرى كنسبة مئوية من تلك القيمة الأعلى (100)
                        القيمة 100 هي أعلى شعبية للمصطلح
                        تعني القيمة 50 أن المصطلح نصف شائع
                        تعني القيمة 0 عدم توفر بيانات كافية لهذا المصطلح

                  • interests_comparison
                    النوع: object | null · Response36Afe1097B20_InterestsComparison

                    مقارنة البيانات حول شعبية الكلمات المفتاحية دون الإقليمية للمعاملات المحددة
                    إذا حددت كلمة مفتاحية واحدة، ستكون القيمة null

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

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

                      • geo_id
                        النوع: string | null

                        معرّف الموقع
                        يمكنك استخدام هذا الحقل لمطابقة النتائج التي حصلت عليها مع معاملات الموقع المحددة في الطلب
                        راجع القائمة الكاملة للمواقع المتاحة مع geo_id الخاص بها هنا أو عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        مثال:
                        US-NY

                      • geo_name
                        النوع: string | null

                        اسم الموقع
                        يمكنك استخدام هذا الحقل لمطابقة النتائج التي حصلت عليها مع معاملات الموقع المحددة في الطلب
                        راجع القائمة الكاملة للمواقع المتاحة مع geo_name الخاص بها هنا أو عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        مثال:
                        Andorra

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

                        تحتوي على بيانات حول الشعبية النسبية للكلمات المفتاحية حسب البلد أو المنطقة

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

                      تحتوي على شعبية الكلمة المفتاحية والبيانات ذات الصلة

                      • geo_id
                        النوع: string | null

                        معرّف الموقع
                        يمكنك استخدام هذا الحقل لمطابقة النتائج التي حصلت عليها مع معاملات الموقع المحددة في الطلب
                        راجع القائمة الكاملة للمواقع المتاحة مع geo_id الخاص بها هنا أو عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        مثال:
                        US-NY

                      • geo_name
                        النوع: string | null

                        اسم الموقع
                        يمكنك استخدام هذا الحقل لمطابقة النتائج التي حصلت عليها مع معاملات الموقع المحددة في الطلب
                        راجع القائمة الكاملة للمواقع المتاحة مع geo_name الخاص بها هنا أو عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        مثال:
                        Andorra

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

                        تحتوي على بيانات حول الشعبية النسبية للكلمات المفتاحية حسب البلد أو المنطقة

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

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

                  • position
                    النوع: integer | null

                    محاذاة العنصر
                    يمكن أن تأخذ القيم التالية: 1، 2، 3، 4، إلخ.

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

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

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

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

          • language_code
            النوع: string | null

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

          • location_code
            النوع: integer | null

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

          • 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 post/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Setting Live ‘DataForSEO Trends Subregion Interests’ Tasks