DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
منافسو تطبيقات Google Play (مباشر)
تطبيقات Google Play المنافسة لتطبيق معيّن على كلمات مفتاحية مشتركة. تُقسَّم إلى صفحات عبر limit وoffset وoffset_token؛ استخدم الرمز بعد الصفحات الأولى. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. النظير في Apple هو post_dataforseo_labs_apple_app_competitors_live. للكلمات المفتاحية وراء التقاطع استخدم post_dataforseo_labs_google_app_intersection_live.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.1356 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: array (object | null)[]
- appالنوع: string
_id معرّف التطبيق
حقل مطلوب
معرّف تطبيق الجوال في Google Play؛
يمكنك العثور على المعرّف في عنوان URL لكل تطبيق مدرج في Google Play؛
مثال:
في عنوان URLhttps://play.google.com/store/apps/details?id=org.telegram.messenger
المعرّف هوorg.telegram.messenger - filtersالنوع: array (object | null)[] | null
مصفوفة معاملات تصفية النتائج
حقل اختياري
يمكنك إضافة عدة عوامل تصفية في وقت واحد (8 عوامل كحد أقصى)
يجب ضبط عامل منطقيandأوorبين الشروط
العوامل المدعومة:<,<=,>,>=,=,<>,in,not_in
مثال:["intersections",">",500][["competitor_metrics.google_play_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]][[["intersections",">=",50],"and",["competitor_metrics.google_play_search_organic.pos_1","in",[1,5]]],
"or",
["sum_position",">=","10000"]]لمزيد من المعلومات حول عوامل التصفية، راجع Dataforseo Labs - Filters أو دليل مركز المساعدة هذا
كائن فارغ - 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 - limitالنوع: integer | null
الحد الأقصى لعدد التطبيقات المعادة
حقل اختياري
القيمة الافتراضية:100
القيمة القصوى:1000 - 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 States - offsetالنوع: integer | null
الإزاحة في مصفوفة نتائج التطبيقات المعادة
حقل اختياري
القيمة الافتراضية:0
إذا حددت القيمة10، فستُحذف أول عشرة تطبيقات من مصفوفة النتائج وستُقدَّم البيانات للكلمات المفتاحية التالية - orderالنوع: array string[] | null
_by قواعد فرز النتائج
حقل اختياري
يمكنك استخدام القيم نفسها الموجودة في مصفوفةfiltersلفرز النتائج؛
أنواع الفرز الممكنة:asc- تُفرز النتائج بترتيب تصاعدي؛desc- تُفرز النتائج بترتيب تنازلي؛
يجب استخدام فاصلة لتحديد نوع الفرز؛
مثال:["intersections,asc"]
ملاحظة: لا يمكنك ضبط أكثر من ثلاث قواعد فرز في طلب واحد؛
يجب استخدام فاصلة للفصل بين عدة قواعد فرز؛
مثال:["intersections,desc","sum_position,asc"]القاعدة الافتراضية:
["intersections,desc"]
ملاحظة: إذا كانت مصفوفةitem_typesتحتوي على أنواع عناصر تختلف عنorganic، فستُرتَّب النتائج حسب نوع العنصر الأول في المصفوفة - tagالنوع: string | null
معرّف مهمة يحدده المستخدم
حقل اختياري
الحد الأقصى للأحرف هو 255
يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
ستجد قيمةtagالمحددة في كائنdataضمن الاستجابة
- النوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo200
- النوع: number | null التنسيق: doublecost
إجمالي تكلفة المهام، بالدولار الأمريكي
- النوع: integer | nullstatus
_code رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
- النوع: string | nullstatus
_message رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا
- النوع: array (object | null)[] | nulltasks
مصفوفة المهام
- النوع: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo
- 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
مصفوفة نتائج
- appالنوع: string | null
_id معرّف التطبيق في مصفوفة POST
- itemsالنوع: array (object | null)[] | null
يحتوي على بيانات تتعلق بـ
app_idوتطبيقات المنافسين- appالنوع: string | null
_id معرّف التطبيق في مصفوفة POST
- avgالنوع: number | null التنسيق: float
_position متوسط موضع التطبيق في SERP على Google Play
ملاحظة: يُحسب متوسط الموضع فقط للكلمات المفتاحية المتقاطعة
قد تختلف القيمة لتطبيق معيّن عند دمجه مع تطبيقات هدف مختلفة - competitorالنوع: object | null
_metrics مقاييس الكلمات المفتاحية المتقاطعة
بيانات ترتيب تتعلق بالكلمات المفتاحية التي يشترك فيها تطبيق المنافس المقدّم مع التطبيق في طلب POST
ملاحظة: في هذه المصفوفة، تُقدَّم بيانات الترتيب لـapp_idالمنافس المُعاد- propertyالنوع: object · Response36Afe1097B20_AppMetricsInfo
Name - countالنوع: integer | null التنسيق: int64
العدد الإجمالي لـ SERP العضوية في Amazon التي تحتوي على المنتج
- posالنوع: integer | null
_1 عدد SERP العضوية التي يحتل فيها المنتج المرتبة #1
- posالنوع: integer | null
_11 _100 عدد SERP العضوية التي يحتل فيها المنتج المراتب #11-100
- posالنوع: integer | null
_2 _3 عدد SERP العضوية التي يحتل فيها المنتج المراتب #2-3
- posالنوع: integer | null
_4 _10 عدد SERP العضوية التي يحتل فيها المنتج المراتب #4-10
- searchالنوع: integer | null التنسيق: int64
_volume إجمالي حجم البحث لكلمات المنتج المفتاحية المرتّبة في SERP العضوية
- fullالنوع: object | null
_metrics مقاييس جميع الكلمات المفتاحية للتطبيق
نظرة شاملة على بيانات الترتيب المتعلقة بجميع الكلمات المفتاحية التي يحقق فيهاapp_idالمقدّم ترتيبًا- propertyالنوع: object · Response36Afe1097B20_AppMetricsInfo
Name - countالنوع: integer | null التنسيق: int64
العدد الإجمالي لـ SERP العضوية في Amazon التي تحتوي على المنتج
- posالنوع: integer | null
_1 عدد SERP العضوية التي يحتل فيها المنتج المرتبة #1
- posالنوع: integer | null
_11 _100 عدد SERP العضوية التي يحتل فيها المنتج المراتب #11-100
- posالنوع: integer | null
_2 _3 عدد SERP العضوية التي يحتل فيها المنتج المراتب #2-3
- posالنوع: integer | null
_4 _10 عدد SERP العضوية التي يحتل فيها المنتج المراتب #4-10
- searchالنوع: integer | null التنسيق: int64
_volume إجمالي حجم البحث لكلمات المنتج المفتاحية المرتّبة في SERP العضوية
- intersectionsالنوع: integer | null
عدد الكلمات المفتاحية المتقاطعة
- seالنوع: string | null
_type نوع محرك البحث
- sumالنوع: integer | null
_position مجموع جميع مواضع التطبيق في SERP على Google Play
ملاحظة: يُحسب مجموع المواضع فقط للكلمات المفتاحية المتقاطعة
قد تختلف القيمة لتطبيق معيّن عند دمجه مع تطبيقات هدف مختلفة
- itemsالنوع: integer | null التنسيق: int64
_count عدد النتائج المُعادة في مصفوفة
items - languageالنوع: string | null
_code رمز اللغة في مصفوفة POST
- locationالنوع: integer | null
_code رمز الموقع في مصفوفة POST
- seالنوع: string | null
_type نوع محرك البحث
- 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/app_competitors/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"app_id": "org.telegram.messenger",
"language_name": "English",
"location_code": 2840,
"limit": 10
}
]'
{
"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,
"app_id": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"app_id": null,
"avg_position": null,
"sum_position": null,
"intersections": null,
"competitor_metrics": null,
"full_metrics": null
}
]
}
]
}
]
}