DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
اقتراحات الكلمات المفتاحية
أشكال الذيل الطويل التي تحتوي على keyword واحدة — عرض مطابقة العبارة، حيث post_dataforseo_labs_google_keyword_ideas_live هو العرض الدلالي. يعيد seed_keyword وseed_keyword_data وtotal_count وoffset_token وitems. تُقسَّم إلى صفحات عبر limit وoffset وoffset_token؛ استخدم الرمز بعد الصفحات الأولى. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.132 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- exactالنوع: boolean | null
_match البحث عن العبارة الدقيقة
حقل اختياري
إذا ضُبط علىtrue، فستتضمن الكلمات المفتاحية المُعادة عبارة الكلمة المفتاحية الدقيقة التي حددتها، مع كلمات أخرى محتملة قبل تلك العبارة أو بعدها
القيمة الافتراضية:false - 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_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["keyword_info.cpc","<",0.5],
"or",
["keyword_info.high_top_of_page_bid","<=",0.5]]]
لمزيد من المعلومات حول عوامل التصفية، راجع Dataforseo Labs - Filters أو دليل مركز المساعدةكائن فارغ - ignoreالنوع: boolean | null
_synonyms تجاهل الكلمات المفتاحية شديدة التشابه
حقل اختياري
إذا ضُبط علىtrue، فستُعاد الكلمات المفتاحية الأساسية فقط، وستُستبعد جميع الكلمات المفتاحية شديدة التشابه؛
القيمة الافتراضية:false - includeالنوع: boolean | null
_clickstream _data تضمين أو استبعاد البيانات المستندة إلى مقاييس Clickstream في النتيجة
حقل اختياري
إذا ضُبط المعامل علىtrue، فستتلقى الحقولclickstream_keyword_infoوkeyword_info_normalized_with_clickstreamوkeyword_info_normalized_with_bingفي الاستجابة
القيمة الافتراضية:false
عند تفعيل هذا المعامل، ستُحتسب عليك ضعف تكلفة الطلبتعرّف على كيفية احتساب المقاييس المستندة إلى Clickstream في مقال مركز المساعدة هذا
- includeالنوع: boolean | null
_seed _keyword تضمين بيانات الكلمة المفتاحية الأولية
حقل اختياري
إذا ضُبط علىtrue، فستُقدَّم بيانات الكلمة المفتاحية الأولية المحددة في حقلkeywordضمن مصفوفةseed_keyword_dataفي الاستجابة
القيمة الافتراضية:false - includeالنوع: boolean | null
_serp _info تضمين بيانات SERP لكل كلمة مفتاحية
حقل اختياري
إذا ضُبط علىtrue، فسنعيد مصفوفةserp_infoتحتوي على بيانات SERP (عدد نتائج البحث وعنوان URL ذي الصلة وميزات SERP) لكل كلمة مفتاحية في الاستجابة
القيمة الافتراضية:false - keywordالنوع: string
- languageالنوع: string | null
_code رمز اللغة
حقل اختياري
إذا استخدمت هذا الحقل، فلا حاجة لتحديدlanguage_name
يمكنك الحصول على قائمة اللغات المتاحة معlanguage_codeالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:en
ملاحظة: إذا حُذف هذا الحقل، فستُضبط النتائج افتراضيًا على اللغة التي تضم أكبر عدد من سجلات الكلمات المفتاحية في الموقع المحدد؛
راجع حقلavailable_languages.keywordsفي نقطة النهاية Locations and Languages لتحديد اللغة الافتراضية - languageالنوع: string | null
_name الاسم الكامل للغة
حقل اختياري
إذا استخدمت هذا الحقل، فلا حاجة لتحديدlanguage_code
يمكنك الحصول على قائمة اللغات المتاحة معlanguage_nameالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:English
ملاحظة: إذا حُذف هذا الحقل، فستُضبط النتائج افتراضيًا على اللغة التي تضم أكبر عدد من سجلات الكلمات المفتاحية في الموقع المحدد؛
راجع حقلavailable_languages.keywordsفي نقطة النهاية Locations and Languages لتحديد اللغة الافتراضية - limitالنوع: integer | null
الحد الأقصى لعدد الكلمات المفتاحية المعادة
حقل اختياري
القيمة الافتراضية:100
القيمة القصوى:1000 - locationالنوع: integer | null
_code رمز الموقع
حقل اختياري
إذا استخدمت هذا الحقل، فلا حاجة لتحديدlocation_name
يمكنك الحصول على قائمة المواقع المتاحة معlocation_codeالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
تجاهل هذا الحقل للحصول على النتائج لجميع المواقع المتاحة
مثال:2840 - locationالنوع: string | null
_name الاسم الكامل للموقع
حقل اختياري
إذا استخدمت هذا الحقل، فلا حاجة لتحديدlocation_code
يمكنك الحصول على قائمة المواقع المتاحة معlocation_nameالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
تجاهل هذا الحقل للحصول على النتائج لجميع المواقع المتاحة
مثال:United Kingdom - offsetالنوع: integer | null
الإزاحة في مصفوفة نتائج الكلمات المفتاحية المُعادة
حقل اختياري
القيمة الافتراضية:0
إذا حددت القيمة10، فستُحذف أول عشر كلمات مفتاحية من مصفوفة النتائج وستُقدَّم البيانات للكلمات المفتاحية التالية
ملاحظة: نوصي باستخدام هذا المعامل فقط عند استرداد ما يصل إلى 10,000 نتيجة
لاسترداد أكثر من 10,000 نتيجة، استخدمoffset_tokenبدلًا من ذلك. - offsetالنوع: string | null
_token رمز إزاحة للطلبات اللاحقة
حقل اختياري
يُقدَّم في الحقل نفسه ضمن استجابة كل طلب؛
استخدم هذا المعامل لتجنب المهلات عند محاولة الحصول على أكثر من 10,000 نتيجة في طلب واحد؛
بتحديد قيمةoffset_tokenالفريدة من مصفوفة الاستجابة، ستحصل على النتائج اللاحقة للمهمة الأولية؛
قيمoffset_tokenفريدة لكل مهمة لاحقة
ملاحظة: إذا حُددoffset_tokenفي الطلب، فلن تُؤخذ جميع المعاملات الأخرى باستثناءlimitفي الاعتبار عند معالجة المهمة.
تعرّف على المزيد حول هذا المعامل في مركز المساعدة لدينا - orderالنوع: array string[] | null
_by قواعد فرز النتائج
حقل اختياري
يمكنك استخدام القيم نفسها الموجودة في مصفوفةfiltersلفرز النتائج
أنواع الفرز الممكنة:asc- تُفرز النتائج بترتيب تصاعديdesc- تُفرز النتائج بترتيب تنازلي
تُستخدم الفاصلة فاصلًا
مثال:["keyword_info.competition,desc"]
القاعدة الافتراضية:["keyword_info.search_volume,desc"]
لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
استخدم فاصلة للفصل بين عدة قواعد فرز
مثال:["keyword_info.search_volume,desc","keyword_info.cpc,desc"] - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة
- النوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordSuggestionsLiveTaskInfo
- costالنوع: number | null التنسيق: double
إجمالي تكلفة المهام، بالدولار الأمريكي
- dataالنوع: object | null
يحتوي على المعاملات نفسها التي حددتها في طلب POST
- propertyالنوع: object | null
Name
- idالنوع: string | null
معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID
- pathالنوع: array (string | null)[] | null
مسار URL
- resultالنوع: array (object | null)[] | null
مصفوفة نتائج
- itemsالنوع: array (object | null)[] | null
يحتوي على كلمات مفتاحية وبيانات ذات صلة
- avgالنوع: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info بيانات الروابط الخلفية للكلمة المفتاحية المُعادة
يوفّر هذا الكائن متوسط عدد الروابط الخلفية والصفحات والنطاقات المُحيلة، بالإضافة إلى متوسط قيم الترتيب بين أفضل 10 صفحات ويب تظهر عضويًا للكلمة المفتاحية- backlinksالنوع: number | null
متوسط عدد الروابط الخلفية
- dofollowالنوع: number | null
متوسط عدد روابط dofollow
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainالنوع: number | null
_domain _rank - rankالنوع: number | null
- referringالنوع: number | null
_domains متوسط عدد النطاقات المُحيلة
- referringالنوع: number | null
_main _domains متوسط عدد النطاقات الرئيسية المُحيلة
- referringالنوع: number | null
_pages متوسط عدد الصفحات المُحيلة
- seالنوع: string | null
_type نوع محرك البحث
- clickstreamالنوع: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info بيانات النقرات للكلمة المفتاحية المُعادة
لاسترداد نتائج هذا الحقل، يجب تعيين المعلمةinclude_clickstream_dataعلىtrue- ageالنوع: object | null
_distribution - propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- genderالنوع: object | null
_distribution - propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - monthlyالنوع: array (object | null)[] | null
_searches عمليات البحث الشهرية
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية هذه (كما هو متاح للأشهر الاثني عشر الماضية)، الموجّهة إلى المواقع الجغرافية المحددة- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- searchالنوع: integer | null التنسيق: int64
_volume معدّل حجم البحث الشهري المتوسط
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com
- keywordالنوع: string | null
فكرة الكلمة المفتاحية المُعادة
- keywordالنوع: object | null · Response36Afe1097B20_KeywordInfo
_info بيانات الكلمة المفتاحية لفكرة الكلمة المفتاحية المُعادة
- categoriesالنوع: array integer[] | null
- competitionالنوع: number | null
المنافسة
تمثّل مقدار المنافسة النسبي المرتبط بالكلمة المفتاحية المحددة. تستند هذه القيمة إلى بيانات Google Ads ويمكن أن تتراوح بين 0 و1 (شاملةً الطرفين) - competitionالنوع: string | null
_level - cpcالنوع: number | null
تكلفة النقرة
تمثّل متوسط تكلفة النقرة (بالدولار الأمريكي) المدفوعة تاريخيًا مقابل الكلمة المفتاحية - highالنوع: number | null
_top _of _page _bid أقصى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
تشير إلى قيمة أكبر من نحو 80% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
قد تختلف القيمة حسب الموقع المحدد في طلب POST - lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - lowالنوع: number | null
_top _of _page _bid أدنى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
تشير إلى قيمة أكبر من نحو 20% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
قد تختلف القيمة حسب الموقع المحدد في طلب POST - monthlyالنوع: array (object | null)[] | null
_searches عمليات البحث الشهرية
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية هذه (كما هو متاح للأشهر الاثني عشر الماضية)، الموجّهة إلى المواقع الجغرافية المحددة- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- seالنوع: string | null
_type نوع محرك البحث
- searchالنوع: integer | null التنسيق: int64
_volume معدّل حجم البحث الشهري المتوسط
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com - searchالنوع: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend تغيّرات اتجاه حجم البحث
تمثّل التغيّر في حجم البحث بالنسبة المئوية مقارنةً بالفترة السابقة- monthlyالنوع: integer | null
تغير حجم البحث بالنسبة المئوية مقارنةً بالشهر السابق
- quarterlyالنوع: integer | null
تغير حجم البحث بالنسبة المئوية مقارنةً بالربع السابق
- yearlyالنوع: integer | null
تغير حجم البحث بالنسبة المئوية مقارنةً بالسنة السابقة
- keywordالنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع حجم بحث Bing
- isالنوع: boolean | null
_normalized تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyالنوع: array (object | null)[] | null
_searches معدلات حجم البحث الشهرية مصفوفة كائنات تحتوي على معدلات حجم البحث في شهر معين من السنة
- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- searchالنوع: integer | null
_volume معدل حجم البحث الحالي لكلمة مفتاحية
- keywordالنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع بيانات النقرات
- isالنوع: boolean | null
_normalized تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyالنوع: array (object | null)[] | null
_searches معدلات حجم البحث الشهرية مصفوفة كائنات تحتوي على معدلات حجم البحث في شهر معين من السنة
- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- searchالنوع: integer | null
_volume معدل حجم البحث الحالي لكلمة مفتاحية
- keywordالنوع: object | null · Response36Afe1097B20_KeywordProperties
_properties معلومات إضافية عن الكلمة المفتاحية
- coreالنوع: string | null
_keyword الكلمة المفتاحية الرئيسية في مجموعة
تحتوي على الكلمة المفتاحية الرئيسية في مجموعة تحددها خوارزمية تجميع المترادفات
إذا كانت القيمةnull، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة معkeyword - detectedالنوع: string | null
_language اللغة المكتشفة للكلمة المفتاحية
تشير إلى لغة الكلمة المفتاحية كما يحددها نظامنا - isالنوع: boolean | null
_another _language اللغة المكتشفة للكلمة المفتاحية مختلفة عن اللغة المحددة
إذا كانت القيمةtrue، فإن اللغة المحددة في الطلب لا تطابق اللغة التي حددها نظامنا لكلمة مفتاحية معينة - keywordالنوع: integer | null
_difficulty - seالنوع: string | null
_type نوع محرك البحث
- synonymالنوع: string | null
_clustering _algorithm الخوارزمية المستخدمة لتحديد المترادفات
القيم الممكنة:keyword_metrics- تشير إلى الخوارزمية المستندة إلى معاملاتkeyword_infotext_processing- تشير إلى الخوارزمية النصية
إذا كانت القيمةnull، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة معkeyword - wordsالنوع: integer | null التنسيق: int64
_count عدد الكلمات في الكلمة المفتاحية
تشير إلى عدد الكلمات التي تتكوّن منها الكلمة المفتاحية
- languageالنوع: string | null
_code رمز اللغة في مصفوفة POST
- locationالنوع: integer | null
_code رمز الموقع في مصفوفة POST
- seالنوع: string | null
_type نوع محرك البحث
- searchالنوع: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignالنوع: array (string | null)[] | null
_intent نيات البحث التكميلية
القيم الممكنة:informational،navigational،commercial،transactional - lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainالنوع: string | null
_intent نية البحث الرئيسية
القيم الممكنة:informational،navigational،commercial،transactional - seالنوع: string | null
_type نوع محرك البحث
- serpالنوع: object | null · Response36Afe1097B20_SerpInfo
_info بيانات SERP
ستكون القيمةnullإذا لم تعيّن الحقلinclude_serp_infoعلىtrueفي مصفوفة POST أو إذا لم تكن هناك بيانات SERP لهذه الكلمة المفتاحية في قاعدة بياناتنا- checkالنوع: string | null
_url عنوان URL مباشر لنتائج محرك البحث
يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة - lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - previousالنوع: string | null
_updated _time التاريخ والوقت السابقان لأحدث تاريخ ووقت حُدّثت فيهما بيانات SERP
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-10-15 12:57:46 +00:00 - seالنوع: integer | null التنسيق: int64
_results _count عدد نتائج البحث للكلمة المفتاحية المعادة
- seالنوع: string | null
_type نوع محرك البحث
- serpالنوع: array (string | null)[] | null
_item _types أنواع نتائج البحث في 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
- itemsالنوع: integer | null التنسيق: int64
_count عدد النتائج المُعادة في مصفوفة
items - languageالنوع: string | null
_code رمز اللغة في مصفوفة POST
فإذا لم تكن هناك بيانات، تكون القيمةnull - locationالنوع: integer | null
_code رمز الموقع في مصفوفة POST
فإذا لم تكن هناك بيانات، تكون القيمةnull - offsetالنوع: integer | null
قيمة الإزاحة الحالية
- offsetالنوع: string | null
_token رمز الإزاحة للطلبات اللاحقة
يمكنك استخدام السلسلة المقدّمة في هذا الحقل للحصول على النتائج اللاحقة للمهمة الأولية؛
ملاحظة: قيمoffset_tokenفريدة لكل مهمة لاحقة - seالنوع: string | null
_type نوع محرك البحث
- seedالنوع: string | null
_keyword الكلمة المفتاحية في مصفوفة POST
- seedالنوع: object | null · Response36Afe1097B20_KeywordDataInfo
_keyword _data بيانات الكلمة المفتاحية للكلمة المفتاحية الأولية
الحقول في هذا الكائن مطابقة لتلك الموجودة في مصفوفةitems- avgالنوع: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info بيانات الروابط الخلفية للكلمة المفتاحية المُعادة
يوفّر هذا الكائن متوسط عدد الروابط الخلفية والصفحات والنطاقات المُحيلة، بالإضافة إلى متوسط قيم الترتيب بين أفضل 10 صفحات ويب تظهر عضويًا للكلمة المفتاحية- backlinksالنوع: number | null
متوسط عدد الروابط الخلفية
- dofollowالنوع: number | null
متوسط عدد روابط dofollow
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainالنوع: number | null
_domain _rank - rankالنوع: number | null
- referringالنوع: number | null
_domains متوسط عدد النطاقات المُحيلة
- referringالنوع: number | null
_main _domains متوسط عدد النطاقات الرئيسية المُحيلة
- referringالنوع: number | null
_pages متوسط عدد الصفحات المُحيلة
- seالنوع: string | null
_type نوع محرك البحث
- clickstreamالنوع: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info بيانات النقرات للكلمة المفتاحية المُعادة
لاسترداد نتائج هذا الحقل، يجب تعيين المعلمةinclude_clickstream_dataعلىtrue- ageالنوع: object | null
_distribution - propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- genderالنوع: object | null
_distribution - propertyالنوع: integer | null التنسيق: int64
Name Signed 64-bit integers (long type).
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - monthlyالنوع: array (object | null)[] | null
_searches عمليات البحث الشهرية
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية هذه (كما هو متاح للأشهر الاثني عشر الماضية)، الموجّهة إلى المواقع الجغرافية المحددة- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- searchالنوع: integer | null التنسيق: int64
_volume معدّل حجم البحث الشهري المتوسط
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com
- keywordالنوع: string | null
فكرة الكلمة المفتاحية المُعادة
- keywordالنوع: object | null · Response36Afe1097B20_KeywordInfo
_info بيانات الكلمة المفتاحية لفكرة الكلمة المفتاحية المُعادة
- categoriesالنوع: array integer[] | null
- competitionالنوع: number | null
المنافسة
تمثّل مقدار المنافسة النسبي المرتبط بالكلمة المفتاحية المحددة. تستند هذه القيمة إلى بيانات Google Ads ويمكن أن تتراوح بين 0 و1 (شاملةً الطرفين) - competitionالنوع: string | null
_level - cpcالنوع: number | null
تكلفة النقرة
تمثّل متوسط تكلفة النقرة (بالدولار الأمريكي) المدفوعة تاريخيًا مقابل الكلمة المفتاحية - highالنوع: number | null
_top _of _page _bid أقصى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
تشير إلى قيمة أكبر من نحو 80% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
قد تختلف القيمة حسب الموقع المحدد في طلب POST - lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - lowالنوع: number | null
_top _of _page _bid أدنى مزايدة لعرض الإعلان في أعلى الصفحة الأولى
تشير إلى قيمة أكبر من نحو 20% من أدنى المزايدات التي عُرضت عندها الإعلانات (استنادًا إلى إحصاءات Google Ads للمعلنين)
قد تختلف القيمة حسب الموقع المحدد في طلب POST - monthlyالنوع: array (object | null)[] | null
_searches عمليات البحث الشهرية
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية هذه (كما هو متاح للأشهر الاثني عشر الماضية)، الموجّهة إلى المواقع الجغرافية المحددة- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- seالنوع: string | null
_type نوع محرك البحث
- searchالنوع: integer | null التنسيق: int64
_volume معدّل حجم البحث الشهري المتوسط
يمثّل العدد (التقريبي) لعمليات البحث على فكرة الكلمة المفتاحية المحددة على google.com - searchالنوع: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend تغيّرات اتجاه حجم البحث
تمثّل التغيّر في حجم البحث بالنسبة المئوية مقارنةً بالفترة السابقة- monthlyالنوع: integer | null
تغير حجم البحث بالنسبة المئوية مقارنةً بالشهر السابق
- quarterlyالنوع: integer | null
تغير حجم البحث بالنسبة المئوية مقارنةً بالربع السابق
- yearlyالنوع: integer | null
تغير حجم البحث بالنسبة المئوية مقارنةً بالسنة السابقة
- keywordالنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع حجم بحث Bing
- isالنوع: boolean | null
_normalized تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyالنوع: array (object | null)[] | null
_searches معدلات حجم البحث الشهرية مصفوفة كائنات تحتوي على معدلات حجم البحث في شهر معين من السنة
- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- searchالنوع: integer | null
_volume معدل حجم البحث الحالي لكلمة مفتاحية
- keywordالنوع: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream تحتوي على حجم بحث الكلمة المفتاحية موحّدًا مع بيانات النقرات
- isالنوع: boolean | null
_normalized تكون معلومات الكلمة المفتاحية مُطبَّعة إذا كانت القيمة true، تُطبَّع القيم باستخدام بيانات Bing
- lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما مجموعة البيانات بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00
- monthlyالنوع: array (object | null)[] | null
_searches معدلات حجم البحث الشهرية مصفوفة كائنات تحتوي على معدلات حجم البحث في شهر معين من السنة
- monthالنوع: integer | null
الشهر
- searchالنوع: integer | null
_volume متوسط معدل حجم البحث الشهري
- yearالنوع: integer | null
السنة
- searchالنوع: integer | null
_volume معدل حجم البحث الحالي لكلمة مفتاحية
- keywordالنوع: object | null · Response36Afe1097B20_KeywordProperties
_properties معلومات إضافية عن الكلمة المفتاحية
- coreالنوع: string | null
_keyword الكلمة المفتاحية الرئيسية في مجموعة
تحتوي على الكلمة المفتاحية الرئيسية في مجموعة تحددها خوارزمية تجميع المترادفات
إذا كانت القيمةnull، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة معkeyword - detectedالنوع: string | null
_language اللغة المكتشفة للكلمة المفتاحية
تشير إلى لغة الكلمة المفتاحية كما يحددها نظامنا - isالنوع: boolean | null
_another _language اللغة المكتشفة للكلمة المفتاحية مختلفة عن اللغة المحددة
إذا كانت القيمةtrue، فإن اللغة المحددة في الطلب لا تطابق اللغة التي حددها نظامنا لكلمة مفتاحية معينة - keywordالنوع: integer | null
_difficulty - seالنوع: string | null
_type نوع محرك البحث
- synonymالنوع: string | null
_clustering _algorithm الخوارزمية المستخدمة لتحديد المترادفات
القيم الممكنة:keyword_metrics- تشير إلى الخوارزمية المستندة إلى معاملاتkeyword_infotext_processing- تشير إلى الخوارزمية النصية
إذا كانت القيمةnull، فلا تحتوي قاعدة بياناتنا على أي كلمات مفتاحية يمكن للخوارزمية المقابلة اعتبارها مترادفة معkeyword - wordsالنوع: integer | null التنسيق: int64
_count عدد الكلمات في الكلمة المفتاحية
تشير إلى عدد الكلمات التي تتكوّن منها الكلمة المفتاحية
- languageالنوع: string | null
_code رمز اللغة في مصفوفة POST
- locationالنوع: integer | null
_code رمز الموقع في مصفوفة POST
- seالنوع: string | null
_type نوع محرك البحث
- searchالنوع: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignالنوع: array (string | null)[] | null
_intent نيات البحث التكميلية
القيم الممكنة:informational،navigational،commercial،transactional - lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - mainالنوع: string | null
_intent نية البحث الرئيسية
القيم الممكنة:informational،navigational،commercial،transactional - seالنوع: string | null
_type نوع محرك البحث
- serpالنوع: object | null · Response36Afe1097B20_SerpInfo
_info بيانات SERP
ستكون القيمةnullإذا لم تعيّن الحقلinclude_serp_infoعلىtrueفي مصفوفة POST أو إذا لم تكن هناك بيانات SERP لهذه الكلمة المفتاحية في قاعدة بياناتنا- checkالنوع: string | null
_url عنوان URL مباشر لنتائج محرك البحث
يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة - lastالنوع: string | null
_updated _time التاريخ والوقت اللذان حُدّثت فيهما بيانات الكلمة المفتاحية
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-11-15 12:57:46 +00:00 - previousالنوع: string | null
_updated _time التاريخ والوقت السابقان لأحدث تاريخ ووقت حُدّثت فيهما بيانات SERP
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:2019-10-15 12:57:46 +00:00 - seالنوع: integer | null التنسيق: int64
_results _count عدد نتائج البحث للكلمة المفتاحية المعادة
- seالنوع: string | null
_type نوع محرك البحث
- serpالنوع: array (string | null)[] | null
_item _types أنواع نتائج البحث في 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النوع: integer | null التنسيق: int64
_count المبلغ الإجمالي للنتائج في قاعدة بياناتنا ذات الصلة بطلبك
- resultالنوع: integer | null التنسيق: int64
_count عدد العناصر في مصفوفة result
- statusالنوع: integer | null
_code رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- statusالنوع: string | null
_message الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- timeالنوع: string | null
وقت التنفيذ، بالثواني
- النوع: integer | null التنسيق: int64tasks
_count عدد المهام في مصفوفة tasks
- النوع: integer | null التنسيق: int64tasks
_error عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ
- النوع: string | nulltime
إجمالي وقت التنفيذ، بالثواني
- النوع: string | nullversion
الإصدار الحالي من API
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "phone",
"location_code": 2840,
"language_code": "en",
"include_serp_info": true,
"include_seed_keyword": true,
"limit": 1
}
]'
{
"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,
"offset": null,
"offset_token": null,
"items": [
{
"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]"
}
]
}
]
}
]
}