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

الكلمات المفتاحية ذات الصلة

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

DataForSEO

​

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

DataForSEO العمليات

الكلمات المفتاحية ذات الصلة

​

يمشي على رسم «عمليات البحث ذات الصلة» الخاص بـGoogle من كلمة مفتاحية نحو الخارج، طبقةً بعد طبقة. ورقّم الصفحات بـlimit وoffset وoffset_token؛ استخدم الرمز بعد الصفحات الأولى. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. يختلف عن نقطتي نهاية الأفكار: فهو يتبع ما يربطه Google نفسه، لا نموذجًا دلاليًا ولا مطابقة سلسلة فرعية.

مرجع التسعير

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

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

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

      عمق البحث بالكلمات المفتاحية
      حقل اختياري
      القيمة الافتراضية: 1

      يعتمد عدد النتائج المُعادة على القيمة التي تحددها في هذا الحقل
      يمكنك تحديد مستوى من 0 إلى 4
      العدد التقديري للكلمات المفتاحية لكل مستوى (الحد الأقصى):
      0 - الكلمة المفتاحية المعيَّنة في حقل keyword
      1 – 8 كلمات مفتاحية
      2 – 72 كلمة مفتاحية
      3 – 584 كلمة مفتاحية
      4 – 4680 كلمة مفتاحية

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

      مصفوفة معاملات تصفية النتائج
      حقل اختياري
      يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 عوامل كحد أقصى)
      يجب تعيين معامل منطقي and أو or بين الشروط
      المعاملات المدعومة:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like,not_like
      يمكنك استخدام المعامل % مع like وnot_like، وكذلك ilike وnot_ilike لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
      مثال:
      ["keyword_data.keyword_info.search_volume",">",0]

      [["keyword_info.search_volume","in",[0,1000]],
      "and",
      ["keyword_data.keyword_info.competition_level","=","LOW"]]

      [["keyword_data.keyword_info.search_volume",">",100],
      "and",
      [["keyword_data.keyword_info.cpc","<",0.5],
      "or",

      ["keyword_info.high_top_of_page_bid","<=",0.5]]]
      لمزيد من المعلومات حول عوامل التصفية، راجع Dataforseo Labs - Filters أو دليل مركز المساعدة

      كائن فارغ
    • ignore_synonyms
      النوع: boolean | null
    • include_clickstream_data
      النوع: boolean | null
    • include_seed_keyword
      النوع: boolean | null

      تضمين بيانات الكلمة المفتاحية الأولية
      حقل اختياري
      إذا ضُبط على true، فستُقدَّم بيانات الكلمة المفتاحية الأولية المحددة في حقل keyword ضمن مصفوفة seed_keyword_data في الاستجابة
      القيمة الافتراضية: false

    • include_serp_info
      النوع: boolean | null

      تضمين بيانات SERP لكل كلمة مفتاحية
      حقل اختياري
      إذا ضُبط على true، فسنعيد مصفوفة serp_info تحتوي على بيانات SERP (عدد نتائج البحث وعنوان URL ذي الصلة وميزات SERP) لكل كلمة مفتاحية في الاستجابة
      القيمة الافتراضية: false

    • keyword
      النوع: string

      keyword
      حقل مطلوب
      ترميز UTF-8
      تُحوَّل الكلمات المفتاحية إلى أحرف صغيرة

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

    • language_code
      النوع: string | null

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

    • language_name
      النوع: string

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

    • limit
      النوع: integer | null

      الحد الأقصى لعدد الكلمات المفتاحية المعادة
      حقل اختياري
      القيمة الافتراضية: 100
      القيمة القصوى: 1000

    • location_code
      النوع: integer

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

    • location_name
      النوع: string

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

    • offset
      النوع: integer | null

      الإزاحة في مصفوفة نتائج الكلمات المفتاحية المعادة
      حقل اختياري
      القيمة الافتراضية: 0
      إذا حددت القيمة 10، فسيُحذف أول عشر كلمات مفتاحية في مصفوفة النتائج وستُقدَّم البيانات للكلمات المفتاحية التالية

    • order_by
      النوع: array string[] | null

      قواعد فرز النتائج
      حقل اختياري
      يمكنك استخدام القيم نفسها الموجودة في مصفوفة filters لفرز النتائج
      أنواع الفرز الممكنة:
      asc - تُفرز النتائج بترتيب تصاعدي
      desc - تُفرز النتائج بترتيب تنازلي
      استخدم فاصلة لتحديد نوع الفرز
      مثال:
      ["keyword_data.keyword_info.competition,desc"]
      القاعدة الافتراضية:
      ["keyword_data.keyword_info.search_volume,desc"]
      لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
      استخدم فاصلة للفصل بين عدة قواعد فرز
      مثال:
      ["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"]

    • replace_with_core_keyword
      النوع: boolean | null

      إعادة بيانات الكلمة المفتاحية الأساسية
      حقل اختياري
      إذا كانت القيمة true، فستُعاد serp_info وrelated_keywords للكلمة المفتاحية الرئيسية في المجموعة التي تنتمي إليها keyword المحددة؛
      إذا كانت القيمة false، فستُعاد serp_info وrelated_keywords للكلمة keyword المحددة (إن توفرت)؛
      راجع مقال مركز المساعدة هذا لمزيد من التفاصيل؛
      القيمة الافتراضية: false

    • tag
      النوع: string | null

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

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

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

            • depth
              النوع: integer | null

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

            • keyword_data
              النوع: object | null · Response36Afe1097B20_KeywordDataInfo

              بيانات الكلمة المفتاحية للكلمة المفتاحية المُعادة

              • avg_backlinks_info
                النوع: object | null · Response36Afe1097B20_AvgBacklinksInfo
                • backlinks
                  النوع: number | null

                  متوسط عدد الروابط الخلفية

                • dofollow
                  النوع: number | null

                  متوسط عدد روابط dofollow

                • last_updated_time
                  النوع: string | null

                  التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

                • main_domain_rank
                  النوع: number | null

                  متوسط ترتيب النطاق الرئيسي
                  اعرف المزيد عن المقياس ومعادلة احتسابه في هذه المقالة في مركز المساعدة

                • rank
                  النوع: number | null

                  متوسط الرتبة
                  تعرّف على المقياس وصيغة حسابه في مقال مركز المساعدة هذا

                • referring_domains
                  النوع: number | null

                  متوسط عدد النطاقات المُحيلة

                • referring_main_domains
                  النوع: number | null

                  متوسط عدد النطاقات الرئيسية المُحيلة

                • referring_pages
                  النوع: number | null

                  متوسط عدد الصفحات المُحيلة

                • se_type
                  النوع: string | null

                  نوع محرك البحث

              • clickstream_keyword_info
                النوع: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

                بيانات النقرات للكلمة المفتاحية المُعادة
                لاسترداد نتائج هذا الحقل، يجب تعيين المعلمة include_clickstream_data على true

                • age_distribution
                  النوع: object | null

                  توزيع المقاييس المستندة إلى Clickstream حسب العمر
                  لمعرفة المزيد حول كيفية حساب المقياس، راجع مقالة مركز المساعدة هذه

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

                    Signed 64-bit integers (long type).

                • gender_distribution
                  النوع: object | null

                  توزيع المقاييس المستندة إلى Clickstream المقدّرة حسب الجنس
                  لمعرفة المزيد حول كيفية حساب المقياس، راجع مقالة مركز المساعدة هذه

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

                    Signed 64-bit integers (long type).

                • last_updated_time
                  النوع: string | null

                  التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

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

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

                  • month
                    النوع: integer | null

                    الشهر

                  • search_volume
                    النوع: integer | null

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

                  • year
                    النوع: integer | null

                    السنة

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

                  معدّل حجم البحث الشهري المتوسط
                  يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com

              • keyword
                النوع: string | null

                فكرة الكلمة المفتاحية المُعادة

              • keyword_info
                النوع: object | null · Response36Afe1097B20_KeywordInfo

                بيانات الكلمة المفتاحية لفكرة الكلمة المفتاحية المُعادة

                • categories
                  النوع: array integer[] | null

                  فئات المنتجات والخدمات
                  يمكنك تنزيل القائمة الكاملة للفئات الممكنة

                • competition
                  النوع: number | null

                  المنافسة
                  تمثّل مقدار المنافسة النسبي المرتبط بالكلمة المفتاحية المحددة. تستند هذه القيمة إلى بيانات Google Ads ويمكن أن تتراوح بين 0 و1 (شاملةً الطرفين)

                • competition_level
                  النوع: string | null

                  مستوى المنافسة
                  يمثّل مستوى المنافسة النسبي المرتبط بالكلمة المفتاحية المحددة في SERP المدفوعة فقط؛
                  القيم الممكنة: LOW، MEDIUM، HIGH
                  إذا كان مستوى المنافسة غير معروف، تكون القيمة null؛
                  اعرف المزيد عن هذا المقياس في مقالة مركز المساعدة هذه

                • cpc
                  النوع: number | null

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

                • high_top_of_page_bid
                  النوع: number | null

                  أقصى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
                  تشير إلى قيمة أكبر من نحو 80% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
                  قد تختلف القيمة حسب الموقع المحدد في طلب POST

                • last_updated_time
                  النوع: string | null

                  التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

                • low_top_of_page_bid
                  النوع: number | null

                  أدنى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
                  تشير إلى قيمة أكبر من نحو 20% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
                  قد تختلف القيمة حسب الموقع المحدد في طلب POST

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

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

                  • month
                    النوع: integer | null

                    الشهر

                  • search_volume
                    النوع: integer | null

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

                  • year
                    النوع: integer | null

                    السنة

                • se_type
                  النوع: string | null

                  نوع محرك البحث

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

                  معدّل حجم البحث الشهري المتوسط
                  يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com

                • search_volume_trend
                  النوع: object | null · Response36Afe1097B20_SearchVolumeTrend

                  تغيّرات اتجاه حجم البحث
                  تمثّل التغيّر في حجم البحث بالنسبة المئوية مقارنةً بالفترة السابقة

                  • monthly
                    النوع: integer | null

                    تغير حجم البحث بالنسبة المئوية مقارنةً بالشهر السابق

                  • quarterly
                    النوع: integer | null

                    تغير حجم البحث بالنسبة المئوية مقارنةً بالربع السابق

                  • yearly
                    النوع: integer | null

                    تغير حجم البحث بالنسبة المئوية مقارنةً بالسنة السابقة

              • keyword_info_normalized_with_bing
                النوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

                تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع حجم بحث Bing

                • is_normalized
                  النوع: boolean | null

                  تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing

                • last_updated_time
                  النوع: string | null

                  التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00

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

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

                  • month
                    النوع: integer | null

                    الشهر

                  • search_volume
                    النوع: integer | null

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

                  • year
                    النوع: integer | null

                    السنة

                • search_volume
                  النوع: integer | null

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

              • keyword_info_normalized_with_clickstream
                النوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

                تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع بيانات النقرات

                • is_normalized
                  النوع: boolean | null

                  تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing

                • last_updated_time
                  النوع: string | null

                  التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00

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

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

                  • month
                    النوع: integer | null

                    الشهر

                  • search_volume
                    النوع: integer | null

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

                  • year
                    النوع: integer | null

                    السنة

                • search_volume
                  النوع: integer | null

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

              • keyword_properties
                النوع: object | null · Response36Afe1097B20_KeywordProperties

                معلومات إضافية عن الكلمة المفتاحية

                • core_keyword
                  النوع: string | null

                  الكلمة المفتاحية الرئيسية في مجموعة
                  تحتوي على الكلمة المفتاحية الرئيسية في مجموعة تحددها خوارزمية تجميع المترادفات
                  إذا كانت القيمة null، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة مع keyword

                • detected_language
                  النوع: string | null

                  اللغة المكتشفة للكلمة المفتاحية
                  تشير إلى لغة الكلمة المفتاحية كما يحددها نظامنا

                • is_another_language
                  النوع: boolean | null

                  اللغة المكتشفة للكلمة المفتاحية مختلفة عن اللغة المحددة
                  إذا كانت القيمة true، فإن اللغة المحددة في الطلب لا تطابق اللغة التي حددها نظامنا لكلمة مفتاحية معينة

                • keyword_difficulty
                  النوع: integer | null

                  صعوبة الترتيب ضمن أفضل 10 نتائج عضوية لكلمة مفتاحية
                  تشير إلى احتمال الوصول إلى أفضل 10 نتائج عضوية لكلمة مفتاحية على مقياس لوغاريتمي من 0 إلى 100؛
                  تُحتسب من خلال تحليل ملفات الروابط لأول 10 صفحات في SERP، إلى جانب معاملات أخرى؛
                  اعرف المزيد عن هذا المقياس في دليل مركز المساعدة هذا

                • se_type
                  النوع: string | null

                  نوع محرك البحث

                • synonym_clustering_algorithm
                  النوع: string | null

                  الخوارزمية المستخدمة لتحديد المترادفات
                  القيم الممكنة:
                  keyword_metrics - تشير إلى الخوارزمية المستندة إلى معاملات keyword_info
                  text_processing - تشير إلى الخوارزمية النصية
                  إذا كانت القيمة null، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة مع keyword

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

                  عدد الكلمات في الكلمة المفتاحية
                  تشير إلى عدد الكلمات التي تتكوّن منها الكلمة المفتاحية

              • language_code
                النوع: string | null

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

              • location_code
                النوع: integer | null

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

              • se_type
                النوع: string | null

                نوع محرك البحث

              • search_intent_info
                النوع: object | null · Response36Afe1097B20_SearchIntentInfo
                • foreign_intent
                  النوع: array (string | null)[] | null

                  نيات البحث التكميلية
                  القيم الممكنة: informational، navigational، commercial، transactional

                • last_updated_time
                  النوع: string | null

                  التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

                • main_intent
                  النوع: string | null

                  نية البحث الرئيسية
                  القيم الممكنة: informational، navigational، commercial، transactional

                • se_type
                  النوع: string | null

                  نوع محرك البحث

              • serp_info
                النوع: object | null · Response36Afe1097B20_SerpInfo

                بيانات SERP
                ستكون القيمة null إذا لم تعيّن الحقل include_serp_info على true في مصفوفة POST أو إذا لم تكن هناك بيانات SERP لهذه الكلمة المفتاحية في قاعدة بياناتنا

                • check_url
                  النوع: string | null

                  عنوان URL مباشر لنتائج محرك البحث
                  يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة

                • last_updated_time
                  النوع: string | null

                  التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

                • previous_updated_time
                  النوع: string | null

                  التاريخ والوقت السابقان لأحدث تاريخ ووقت حُدّثت فيهما بيانات SERP
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-10-15 12:57:46 +00:00

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

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

                • se_type
                  النوع: string | null

                  نوع محرك البحث

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

                  أنواع نتائج البحث في SERP
                  تحتوي على أنواع نتائج البحث (items) الموجودة في SERP
                  أنواع العناصر الممكنة:
                  answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                  ملاحظة أنه لن تُعاد النتائج الفعلية إلا لعناصر organic وpaid وfeatured_snippet وlocal_pack

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

              قائمة الكلمات المفتاحية ذات الصلة
              تمثّل قائمة استعلامات البحث ذات الصلة بالكلمة المفتاحية المُعادة في المصفوفة أعلاه

            • se_type
              النوع: string | null

              نوع محرك البحث

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

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

          • language_code
            النوع: string | null

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

          • location_code
            النوع: integer | null

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

          • se_type
            النوع: string | null

            نوع محرك البحث

          • seed_keyword
            النوع: string | null

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

          • seed_keyword_data
            النوع: object | null · Response36Afe1097B20_KeywordDataInfo

            بيانات الكلمة المفتاحية للكلمة المفتاحية الأولية
            الحقول في المصفوفة مطابقة لتلك الموجودة في keyword_data

            • avg_backlinks_info
              النوع: object | null · Response36Afe1097B20_AvgBacklinksInfo

              بيانات الروابط الخلفية للكلمة المفتاحية المُعادة
              يوفّر هذا الكائن متوسط عدد الروابط الخلفية والصفحات والنطاقات المُحيلة، بالإضافة إلى متوسط قيم الترتيب بين أفضل 10 صفحات ويب تظهر عضويًا للكلمة المفتاحية

              • backlinks
                النوع: number | null

                متوسط عدد الروابط الخلفية

              • dofollow
                النوع: number | null

                متوسط عدد روابط dofollow

              • last_updated_time
                النوع: string | null

                التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                مثال:
                2019-11-15 12:57:46 +00:00

              • main_domain_rank
                النوع: number | null

                متوسط ترتيب النطاق الرئيسي
                اعرف المزيد عن المقياس ومعادلة احتسابه في هذه المقالة في مركز المساعدة

              • rank
                النوع: number | null

                متوسط الرتبة
                تعرّف على المقياس وصيغة حسابه في مقال مركز المساعدة هذا

              • referring_domains
                النوع: number | null

                متوسط عدد النطاقات المُحيلة

              • referring_main_domains
                النوع: number | null

                متوسط عدد النطاقات الرئيسية المُحيلة

              • referring_pages
                النوع: number | null

                متوسط عدد الصفحات المُحيلة

              • se_type
                النوع: string | null

                نوع محرك البحث

            • clickstream_keyword_info
              النوع: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              بيانات النقرات للكلمة المفتاحية المُعادة
              لاسترداد نتائج هذا الحقل، يجب تعيين المعلمة include_clickstream_data على true

              • age_distribution
                النوع: object | null

                توزيع المقاييس المستندة إلى Clickstream حسب العمر
                لمعرفة المزيد حول كيفية حساب المقياس، راجع مقالة مركز المساعدة هذه

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

                  Signed 64-bit integers (long type).

              • gender_distribution
                النوع: object | null

                توزيع المقاييس المستندة إلى Clickstream المقدّرة حسب الجنس
                لمعرفة المزيد حول كيفية حساب المقياس، راجع مقالة مركز المساعدة هذه

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

                  Signed 64-bit integers (long type).

              • last_updated_time
                النوع: string | null

                التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                مثال:
                2019-11-15 12:57:46 +00:00

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

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

                • month
                  النوع: integer | null

                  الشهر

                • search_volume
                  النوع: integer | null

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

                • year
                  النوع: integer | null

                  السنة

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

                معدّل حجم البحث الشهري المتوسط
                يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com

            • keyword
              النوع: string | null

              فكرة الكلمة المفتاحية المُعادة

            • keyword_info
              النوع: object | null · Response36Afe1097B20_KeywordInfo

              بيانات الكلمة المفتاحية لفكرة الكلمة المفتاحية المُعادة

              • categories
                النوع: array integer[] | null

                فئات المنتجات والخدمات
                يمكنك تنزيل القائمة الكاملة للفئات الممكنة

              • competition
                النوع: number | null

                المنافسة
                تمثّل مقدار المنافسة النسبي المرتبط بالكلمة المفتاحية المحددة. تستند هذه القيمة إلى بيانات Google Ads ويمكن أن تتراوح بين 0 و1 (شاملةً الطرفين)

              • competition_level
                النوع: string | null

                مستوى المنافسة
                يمثّل مستوى المنافسة النسبي المرتبط بالكلمة المفتاحية المحددة في SERP المدفوعة فقط؛
                القيم الممكنة: LOW، MEDIUM، HIGH
                إذا كان مستوى المنافسة غير معروف، تكون القيمة null؛
                اعرف المزيد عن هذا المقياس في مقالة مركز المساعدة هذه

              • cpc
                النوع: number | null

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

              • high_top_of_page_bid
                النوع: number | null

                أقصى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
                تشير إلى قيمة أكبر من نحو 80% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
                قد تختلف القيمة حسب الموقع المحدد في طلب POST

              • last_updated_time
                النوع: string | null

                التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                مثال:
                2019-11-15 12:57:46 +00:00

              • low_top_of_page_bid
                النوع: number | null

                أدنى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
                تشير إلى قيمة أكبر من نحو 20% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
                قد تختلف القيمة حسب الموقع المحدد في طلب POST

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

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

                • month
                  النوع: integer | null

                  الشهر

                • search_volume
                  النوع: integer | null

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

                • year
                  النوع: integer | null

                  السنة

              • se_type
                النوع: string | null

                نوع محرك البحث

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

                معدّل حجم البحث الشهري المتوسط
                يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com

              • search_volume_trend
                النوع: object | null · Response36Afe1097B20_SearchVolumeTrend

                تغيّرات اتجاه حجم البحث
                تمثّل التغيّر في حجم البحث بالنسبة المئوية مقارنةً بالفترة السابقة

                • monthly
                  النوع: integer | null

                  تغير حجم البحث بالنسبة المئوية مقارنةً بالشهر السابق

                • quarterly
                  النوع: integer | null

                  تغير حجم البحث بالنسبة المئوية مقارنةً بالربع السابق

                • yearly
                  النوع: integer | null

                  تغير حجم البحث بالنسبة المئوية مقارنةً بالسنة السابقة

            • keyword_info_normalized_with_bing
              النوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع حجم بحث Bing

              • is_normalized
                النوع: boolean | null

                تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing

              • last_updated_time
                النوع: string | null

                التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00

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

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

                • month
                  النوع: integer | null

                  الشهر

                • search_volume
                  النوع: integer | null

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

                • year
                  النوع: integer | null

                  السنة

              • search_volume
                النوع: integer | null

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

            • keyword_info_normalized_with_clickstream
              النوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع بيانات النقرات

              • is_normalized
                النوع: boolean | null

                تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing

              • last_updated_time
                النوع: string | null

                التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00

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

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

                • month
                  النوع: integer | null

                  الشهر

                • search_volume
                  النوع: integer | null

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

                • year
                  النوع: integer | null

                  السنة

              • search_volume
                النوع: integer | null

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

            • keyword_properties
              النوع: object | null · Response36Afe1097B20_KeywordProperties

              معلومات إضافية عن الكلمة المفتاحية

              • core_keyword
                النوع: string | null

                الكلمة المفتاحية الرئيسية في مجموعة
                تحتوي على الكلمة المفتاحية الرئيسية في مجموعة تحددها خوارزمية تجميع المترادفات
                إذا كانت القيمة null، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة مع keyword

              • detected_language
                النوع: string | null

                اللغة المكتشفة للكلمة المفتاحية
                تشير إلى لغة الكلمة المفتاحية كما يحددها نظامنا

              • is_another_language
                النوع: boolean | null

                اللغة المكتشفة للكلمة المفتاحية مختلفة عن اللغة المحددة
                إذا كانت القيمة true، فإن اللغة المحددة في الطلب لا تطابق اللغة التي حددها نظامنا لكلمة مفتاحية معينة

              • keyword_difficulty
                النوع: integer | null

                صعوبة الترتيب ضمن أفضل 10 نتائج عضوية لكلمة مفتاحية
                تشير إلى احتمال الوصول إلى أفضل 10 نتائج عضوية لكلمة مفتاحية على مقياس لوغاريتمي من 0 إلى 100؛
                تُحتسب من خلال تحليل ملفات الروابط لأول 10 صفحات في SERP، إلى جانب معاملات أخرى؛
                اعرف المزيد عن هذا المقياس في دليل مركز المساعدة هذا

              • se_type
                النوع: string | null

                نوع محرك البحث

              • synonym_clustering_algorithm
                النوع: string | null

                الخوارزمية المستخدمة لتحديد المترادفات
                القيم الممكنة:
                keyword_metrics - تشير إلى الخوارزمية المستندة إلى معاملات keyword_info
                text_processing - تشير إلى الخوارزمية النصية
                إذا كانت القيمة null، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة مع keyword

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

                عدد الكلمات في الكلمة المفتاحية
                تشير إلى عدد الكلمات التي تتكوّن منها الكلمة المفتاحية

            • language_code
              النوع: string | null

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

            • location_code
              النوع: integer | null

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

            • se_type
              النوع: string | null

              نوع محرك البحث

            • search_intent_info
              النوع: object | null · Response36Afe1097B20_SearchIntentInfo

              معلومات نية البحث للكلمة المفتاحية المُعادة
              تعرّف على نية البحث في مقالة مركز المساعدة هذه

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

                نيات البحث التكميلية
                القيم الممكنة: informational، navigational، commercial، transactional

              • last_updated_time
                النوع: string | null

                التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                مثال:
                2019-11-15 12:57:46 +00:00

              • main_intent
                النوع: string | null

                نية البحث الرئيسية
                القيم الممكنة: informational، navigational، commercial، transactional

              • se_type
                النوع: string | null

                نوع محرك البحث

            • serp_info
              النوع: object | null · Response36Afe1097B20_SerpInfo

              بيانات SERP
              ستكون القيمة null إذا لم تعيّن الحقل include_serp_info على true في مصفوفة POST أو إذا لم تكن هناك بيانات SERP لهذه الكلمة المفتاحية في قاعدة بياناتنا

              • check_url
                النوع: string | null

                عنوان URL مباشر لنتائج محرك البحث
                يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة

              • last_updated_time
                النوع: string | null

                التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
                بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                مثال:
                2019-11-15 12:57:46 +00:00

              • previous_updated_time
                النوع: string | null

                التاريخ والوقت السابقان لأحدث تاريخ ووقت حُدّثت فيهما بيانات SERP
                بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                مثال:
                2019-10-15 12:57:46 +00:00

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

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

              • se_type
                النوع: string | null

                نوع محرك البحث

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

                أنواع نتائج البحث في SERP
                تحتوي على أنواع نتائج البحث (items) الموجودة في SERP
                أنواع العناصر الممكنة:
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                ملاحظة أنه لن تُعاد النتائج الفعلية إلا لعناصر organic وpaid وfeatured_snippet وlocal_pack

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

            المبلغ الإجمالي للنتائج في قاعدة بياناتنا ذات الصلة بطلبك

        • 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/dataforseo_labs/google/related_keywords/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/related_keywords/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "phone",
    "language_name": "English",
    "location_code": 2840,
    "limit": 3
  }
]'

{
  "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": [
        {
          "se_type": null,
          "seed_keyword": null,
          "seed_keyword_data": {
            "se_type": null,
            "keyword": null,
            "location_code": null,
            "language_code": null,
            "keyword_info": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
            "clickstream_keyword_info": "[Max Depth Exceeded]",
            "keyword_properties": "[Max Depth Exceeded]",
            "serp_info": "[Max Depth Exceeded]",
            "avg_backlinks_info": "[Max Depth Exceeded]",
            "search_intent_info": "[Max Depth Exceeded]"
          },
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "avg_backlinks_info": "[Max Depth Exceeded]",
                "search_intent_info": "[Max Depth Exceeded]"
              },
              "depth": null,
              "related_keywords": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Related Keywords