البحث بالهاشتاج

يمكنك العثور على وسائط IG العامة التي تم الإشارة إليها بعلامات هاشتاج محددة.

التقييدات

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

المتطلبات

لاستخدام واجهة API هذه، يجب الخضوع إلى عملية مراجعة التطبيقات وطلب الحصول على اعتماد لما يلي:

• الميزة Instagram Public Content Access
• الإذن instagram_basic

نقاط النهاية

تتكوّن واجهة API البحث بالهاشتاج من العُقد وعناصر الربط التالية:

• GET /ig_hashtag_search — يمكن استخدامه للحصول على معرف العقدة في هاشتاج محدد
• GET /{ig-hashtag-id} — يمكن استخدامه للحصول على بيانات حول هاشتاج
• GET /{ig-hashtag-id}/top_media — يمكن استخدامه للحصول على الصور ومقاطع الفيديو الأكثر رواجًا وتتضمن إحدى علامات الهاشتاج المحددة
• GET /{ig-hashtag-id}/recent_media — يمكن استخدامه للحصول على أحدث الصور ومقاطع الفيديو المنشورة وتتضمن إحدى علامات الهاشتاج المحددة
• GET /{ig-user-id}/recently_searched_hashtags — يمكن استخدامه لتحديد علامات الهاشتاج الفريدة التي بحث عنها حساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram خلال الأسبوع الحالي

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

الاستخدامات الشائعة

الحصول على الوسائط التي تمت الإشارة إليها بهاشتاج

للحصول على جميع الصور ومقاطع الفيديو التي تتضمن إحدى علامات الهاشتاج المحددة، استخدم أولًا نقطة النهاية /ig_hashtag_search واحرص على تضمين الهاشتاج والمعرف الخاص بحساب Instagram للأعمال أو حساب منشئ المحتوى على Instagram الذي يجري الاستعلام. فعلى سبيل المثال، إذا تم إجراء الاستعلام نيابة عن حساب Instagram للأعمال باستخدام المعرف 17841405309211844، فيمكنك الحصول على معرف الهاشتاج "‎#coke" عن طريق إجراء الاستعلام التالي:

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

سيؤدي ذلك إلى إرجاع معرف عقدة الهاشتاج "‎#Coke":

{
  "id" : "17873440459141021"
}

الآن بعد أن أصبح معرف الهاشتاج (17873440459141021) متوفرًا لديك، يمكنك الاستعلام عن عنصر الربط /top_media أو /recent_media التابع له وتضمين معرف حساب الأعمال للحصول على مجموعة من كائنات الوسائط التي تحتوي على الهاشتاج "‎#coke". على سبيل المثال:

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

سيؤدي ذلك إلى إرجاع استجابة تبدو كما يلي:

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}