DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
نظرة عامة على الكلمات المفتاحية
كل ما تعرفه Labs عن قائمة keywords في استدعاء واحد: الحجم والصعوبة والنية والمنافسة وميزات SERP التي تثيرها. يعيد se_type وlocation_code وlanguage_code وitems_count وitems. لا يقبل هذا الإجراء معامل حد أقصى، لكنه يُسعَّر لكل استدعاء لا لكل عنصر، لذا أرسل القائمة كاملة دفعة واحدة. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. ابدأ هنا عندما تكون لديك كلمات مفتاحية؛ وpost_dataforseo_labs_google_keyword_ideas_live هي وجهتك عندما تحتاج المزيد منها.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.0254 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- 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
_serp _info تضمين بيانات SERP لكل كلمة مفتاحية
حقل اختياري
إذا ضُبط علىtrue، فسنعيد مصفوفةserp_infoتحتوي على بيانات SERP (عدد نتائج البحث وعنوان URL ذي الصلة وميزات SERP) لكل كلمة مفتاحية في الاستجابة
القيمة الافتراضية:false - keywordsالنوع: array string[]
keywords
حقل مطلوب
الحد الأقصى لعدد الكلمات المفتاحية التي يمكنك تحديدها: 700
الحد الأقصى لعدد الأحرف في كل كلمة مفتاحية: 80
الحد الأقصى لعدد الكلمات في كل عبارة مفتاحية: 10
ستُحوَّل الكلمات المفتاحية المحددة إلى صيغة أحرف صغيرة، وستُقدَّم البيانات في مصفوفة منفصلةملاحظة أنه إذا حُذفت بعض الكلمات المفتاحية المحددة في هذه المصفوفة من النتائج التي تتلقاها، فذلك يعني أن قاعدة بياناتنا لا تحتوي على هذه الكلمات ولا يمكنها إرجاع بيانات عنها
لن تُحتسب عليك رسوم للكلمات المفتاحية المحذوفة من النتائجتعرّف على قواعد وقيود حقلَي
keywordوkeywordsفي واجهات DataForSEO API في مقال مركز المساعدة - languageالنوع: string | null
_code رمز اللغة
حقل مطلوب إذا لم تحددlanguage_name
ملاحظة: يجب تحديدlanguage_nameأوlanguage_code
يمكنك الحصول على قائمة المواقع المتاحة معlanguage_codeالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:en - languageالنوع: string
_name الاسم الكامل للغة
حقل مطلوب إذا لم تحددlanguage_code
ملاحظة: يجب تحديدlanguage_nameأوlanguage_code
يمكنك الحصول على قائمة المواقع المتاحة معlanguage_nameالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:English - locationالنوع: integer
_code رمز الموقع
حقل مطلوب إذا لم تحددlocation_name
ملاحظة: يجب تحديدlocation_nameأوlocation_code
يمكنك الحصول على قائمة المواقع المتاحة معlocation_codeالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:2840 - locationالنوع: string
_name الاسم الكامل للموقع
حقل مطلوب إذا لم تحددlocation_code
ملاحظة: يجب تحديدlocation_nameأوlocation_code
يمكنك الحصول على قائمة المواقع المتاحة معlocation_nameالخاص بها عبر إرسال طلب منفصل إلىhttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
مثال:United Kingdom - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة
- النوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
- 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 نوع محرك البحث
- searchالنوع: boolean | null
_partners يشير إلى البيانات الخاصة بـGoogle والمواقع الشريكة
إذا كانتtrue، تُعاد النتائج للشبكات المملوكة والمشغّلة والموزّعة عبر Google والمواقع الشريكة التي تستضيف بحث Google
إذا كانتfalse، تُعاد النتائج لمواقع بحث Google فقط - 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
- locationالنوع: integer | null
_code رمز الموقع في مصفوفة POST
- seالنوع: string | null
_type نوع محرك البحث
- 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_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
}
]'
{
"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,
"location_code": null,
"language_code": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"search_partners": 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]"
}
]
}
]
}
]
}