استنادًا إلى نتائج البحث، فإن الاختلاف الرئيسي بين نقطتي نهاية واجهة برمجة التطبيقات `phrase_all` و`phrase_this` لتقرير نظرة عامة على الكلمات الرئيسية هو:
1. كل العبارة:
- تقوم نقطة النهاية هذه باسترداد بيانات نظرة عامة على الكلمات الرئيسية لكلمة رئيسية معينة عبر جميع قواعد البيانات الإقليمية المتاحة.
- يقوم بإرجاع مقاييس الكلمات الرئيسية (حجم البحث، وتكلفة النقرة، والمنافسة، وما إلى ذلك) مجمعة عبر جميع قواعد البيانات.
- يكون هذا مفيدًا عندما تريد الحصول على نظرة شاملة لأداء الكلمة الرئيسية.
2. العبارة_هذه :
- تقوم نقطة النهاية هذه باسترداد بيانات نظرة عامة على الكلمات الرئيسية لكلمة رئيسية معينة، ولكن لقاعدة بيانات إقليمية محددة.
- تحتاج إلى تحديد معلمة "قاعدة البيانات" للإشارة إلى قاعدة البيانات الإقليمية التي تريد البيانات الخاصة بها (على سبيل المثال، "قاعدة البيانات=نا").
- يتيح لك هذا الحصول على بيانات أكثر تفصيلاً خاصة بالمنطقة للكلمة الرئيسية.
في ملخص:
- `phrase_all` يوفر لك بيانات النظرة العامة على الكلمات الرئيسية المجمعة في جميع المناطق.
- `phrase_this` يسمح لك باسترداد نظرة عامة على الكلمات الرئيسية لقاعدة بيانات إقليمية محددة.
يعتمد الاختيار بين الاثنين على ما إذا كنت بحاجة إلى عرض عام أو أكثر محلية لبيانات الكلمات الرئيسية. إذا كنت تستهدف سوقًا محددًا، فإن استخدام نقطة النهاية `phrase_this` مع قاعدة البيانات الإقليمية المناسبة سيكون أكثر ملاءمة. إذا كنت تريد منظورًا شاملاً عبر المناطق، فستكون نقطة النهاية `phrase_all` أكثر ملاءمة.
تدعم كلا نقطتي النهاية معلمات إضافية مثل `display_limit` و`export_columns` لتخصيص البيانات التي يتم إرجاعها في الاستجابة.
اقتباسات:[1] https://www.semrush.com/kb/257-keyword-overview
[2] https://www.semrush.com/kb/972-api-reports
[3] https://developer.semrush.com/api/v3/analytics/keyword-reports/
[4] https://www.semrush.com/features/keyword-research/
[5] https://www.semrush.com/analytics/keywordoverview/