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 العمليات

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

​

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

مرجع التسعير

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

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

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

      عمق البحث بالكلمات المفتاحية
      حقل اختياري
      القيمة الافتراضية: 1؛
      يعتمد عدد النتائج المعادة على القيمة التي تضبطها في هذا الحقل؛
      يمكنك تحديد مستوى من 0 إلى 4؛
      العدد التقديري للكلمات المفتاحية لكل مستوى (الحد الأقصى):
      0 - الكلمة المفتاحية المحددة في حقل keyword
      1 – 6 كلمات مفتاحية
      2 – 42 كلمة مفتاحية
      3 – 258 كلمة مفتاحية
      4 – 1554 كلمة مفتاحية

    • ignore_synonyms
      النوع: boolean | null

      تجاهل الكلمات المفتاحية شديدة التشابه
      حقل اختياري
      إذا ضُبط على true فلن تُعاد إلا الكلمات المفتاحية الأساسية، وتُستبعد كل الكلمات المفتاحية شديدة التشابه؛
      القيمة الافتراضية: false

    • include_seed_keyword
      النوع: boolean | null

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

    • keyword
      النوع: string

      الكلمة المفتاحية
      حقل مطلوب
      ترميز 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 States

    • offset
      النوع: integer | null

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

    • tag
      النوع: string | null

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

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

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

              • keyword
                النوع: string | null

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

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

                معلومات الكلمة المفتاحية للكلمة المعادة

                • last_updated_time
                  النوع: string | null

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

                • se_type
                  النوع: string | null

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

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

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

              • language_code
                النوع: string | null

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

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

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

              • se_type
                النوع: string | null

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

            • related_keywords
              النوع: array string[] | 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_AmazonKeywordData

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

            • keyword
              النوع: string | null

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

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

              معلومات الكلمة المفتاحية للكلمة المعادة

              • last_updated_time
                النوع: string | null

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

              • se_type
                النوع: string | null

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

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

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

            • language_code
              النوع: string | null

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

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

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

            • se_type
              النوع: string | null

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

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

{
  "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]"
          },
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": "[Max Depth Exceeded]",
              "depth": null,
              "related_keywords": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Related Keywords