العبارات الأكثر بحثًا

نشرح في هذا المقال طريقة معرفة العبارات الأكثر بحثًا التي أجراها الأشخاص ضمن مقالات مركز المساعدة، والاستفادة منها في عرض تقارير إحصائية مفيدة وتحسين المحتوى.

تطبيق الأمثلة، سنفترض وجود مركز مساعدة على النطاق example.com، ومفتاح الواجهة البرمجية لزيتون مخزن ضمن متغير TOKEN$ لاستخدامه في الطلبات المختلفة.

export TOKEN="YOUR_API_KEY"

عرض العبارات الأكثر بحثاً

يمكنك إرسال طلب من النوع GET إلى نقطة الوصول search-phrases/ للاطلاع على أكثر الكلمات أو العبارات التي يبحث عنها الأشخاص في قاعدة معرفة مركز المساعدة، وعدد مرات البحث عنها، مع مجموعة من معاملات الاستعلام المساعدة في تصفية النتائج تبعًا لتاريخ البحث أو رقم وبريد الشخص الذي يجري عملية البحث.

الكلمات الأكثر بحثًا بشهر

لمعرفة أكثر الكلمات التي أجرى الأشخاص بحثًا عنها في مقالات قاعدة المعرفة خلال شهر يناير على سبيل المثال نكتب الطلب على النحو التالي:

curl "https://example.com/api/agent/v1/search-phrases?from_date=01-01-2025&to_date=31-01-2025&group_by=phrase" \
  -H "Authorization: Bearer @TOKEN"

الكلمات الأكثر بحثًا من رقم شخص

لمعرفة أكثر الكلمات التي بحث عنها الشخص الذي يملك الرقم التعريفي 1001 مثلًا نكتب الطلب على النحو التالي:

curl "https://example.com/api/agent/v1/search-phrases?user_id=1001&group_by=phrase" \
  -H "Authorization: Bearer @TOKEN"

الكلمات الأكثر بحثًا من بريد إلكتروني

لمعرفة أكثر الكلمات التي بحث عنها صاحب البريد الإلكتروني email@example.com نكتب الطلب التالي:

curl "https://example.com/api/agent/v1/search-phrases?email=email%40example.com&group_by=phrase" \
  -H "Authorization: Bearer @TOKEN"