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

إعداد مهام ‘Keywords For Keywords’

الخادم:https://openapi.felo.ai
مكتبات العملاء

DataForSEO

​

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

إعداد مهام ‘Keywords For Keywords’

​

يضع في قائمة الانتظار توسيعًا لكلمات مفتاحية في Google Ads، ويعيد معرّف مهمة id. يقبل target إلى جانب keywords، وهو ما لا تفعله النقطة المباشرة. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. 🔴 النتيجة بالحجم نفسه من رتبة 2.8 MB كالنظير المباشر — فالإرسال إلى قائمة الانتظار يؤجّل تكلفة السياق ولا يقلّلها. استرجعها عبر get_dataforseo_keywords_gads_kw_for_keywords_fetch.

مرجع التسعير

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

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

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

      تاريخ بدء النطاق الزمني
      حقل اختياري
      صيغة التاريخ: "yyyy-mm-dd"
      الحد الأدنى للقيمة: 4 سنوات من التاريخ الحالي
      بشكل افتراضي، تُعاد البيانات للـ 12 شهرًا الماضية؛
      ملاحظة: لا يمكن أن يكون التاريخ المحدد أكبر من التاريخ المحدد في date_to و/أو تاريخ الأمس؛ إذا أعادت نقطة نهاية الحالة القيمة false في الحقل actual_data، فيمكن ضبط date_from على الشهر قبل الماضي وما قبله؛
      إذا أعادت نقطة نهاية الحالة القيمة true في الحقل actual_data، فيمكن ضبط date_from على الشهر الماضي وما قبله

    • date_to
      النوع: string | null

      تاريخ انتهاء النطاق الزمني
      حقل اختياري
      ملاحظة: لا يمكن أن يكون التاريخ المحدد أكبر من تاريخ الأمس؛
      إذا لم تحدد هذا الحقل، فسيُستخدم تاريخ الأمس افتراضيًا
      صيغة التاريخ: "yyyy-mm-dd"
      مثال:
      "2022-11-30"

    • include_adult_keywords
      النوع: boolean | null

      تضمين الكلمات المفتاحية المرتبطة بمحتوى للبالغين
      حقل اختياري
      إذا عُيّن على true، فستُضمَّن الكلمات المفتاحية للبالغين في الاستجابة
      القيمة الافتراضية: false
      لاحظ أن API قد لا يعيد بيانات لهذه الكلمات المفتاحية بسبب قيود Google Ads

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

      الكلمات المفتاحية
      حقل مطلوب
      الحد الأقصى لعدد الكلمات المفتاحية التي يمكنك تحديدها: 20
      الحد الأقصى لعدد الأحرف لكل كلمة مفتاحية: 80
      ستُحوَّل الكلمات المفتاحية التي تحددها إلى أحرف صغيرة
      ملاحظة: قد لا يعيد Google Ads بيانات لبعض مجموعات الكلمات المفتاحية
      زُر مركز المساعدة لدينا لمعرفة المزيد
      لاحظ أيضًا أن Google Ads لا يسمح باستخدام رموز وأحرف معينة (مثل رموز UTF والرموز التعبيرية)، لذا لا يمكنك استخدامها عند إعداد المهمة؛
      لمعرفة المزيد حول الرموز والأحرف التي يمكن استخدامها، راجع هذا المقال

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

    • language_code
      النوع: string | null

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

    • language_name
      النوع: string | null

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

    • location_code
      النوع: integer | null

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

    • location_coordinate
      النوع: string | null

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

    • location_name
      النوع: string | null

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

    • pingback_url
      النوع: string | null

      عنوان URL لإشعار اكتمال المهمة
      حقل اختياري
      عند اكتمال المهمة، سنُشعرك عبر طلب GET يُرسل إلى عنوان URL الذي حددته
      يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب
      مثال:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      ملاحظة: تُرمَّز الأحرف الخاصة في pingback_url بترميز urlencoded;
      منها أن الحرف # يُرمَّز إلى %23

      تعرّف على المزيد في مركز المساعدة

    • postback_url
      النوع: string | null

      عنوان URL لإرسال نتائج المهمة
      حقل اختياري
      بعد اكتمال المهمة، سنرسل طلب POST بنتائجها مضغوطة بصيغة gzip إلى postback_url الذي حددته
      يمكنك استخدام السلسلة ‘$id’ كمتغيّر $id و‘$tag’ كمتغيّر $tag بترميز urlencoded. سنضبط القيم اللازمة قبل إرسال الطلب.
      مثال:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      ملاحظة: تُرمَّز الأحرف الخاصة في postback_url بترميز urlencoded;
      منها أن الحرف # يُرمَّز إلى %23

      تعرّف على المزيد في مركز المساعدة

    • search_partners
      النوع: boolean | null

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

    • sort_by
      النوع: string | null

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

    • tag
      النوع: string | null

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

    • target
      النوع: string | null

      الموقع المستهدف
      حقل اختياري
      حدد موقعًا إلكترونيًا أو عنوان URL للحصول على قائمة كلمات مفتاحية ذات صلة به؛
      ملاحظة: إذا تم تحديد عنوان URL لموقع، فستحصل مع ذلك على كلمات مفتاحية ذات صلة بالموقع بأكمله

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

      • النوع: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsKeywordsForKeywordsTaskPostTaskInfo
        • cost
          النوع: number | null التنسيق: double

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

        • data
          النوع: object | null

          يحتوي على المعاملات نفسها التي حددتها في طلب POST

          • propertyName
            النوع: object | null
        • id
          النوع: string | null

          معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

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

          مسار URL

        • result
          النوع: object | null

          مصفوفة نتائج
          في هذه الحالة، ستكون القيمة 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/google_ads/keywords_for_keywords/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/keywords_for_keywords/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "keywords": [
      "phone",
      "cellphone"
    ]
  }
]'
{
  "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": null
    }
  ]
}
Setting ‘Keywords For Keywords’ Tasks

هل تحتاج إلى مساعدة؟