يمكنك العثور على وسائط IG العامة التي تم الإشارة إليها بعلامات هاشتاج محددة.
لاستخدام واجهة API هذه، يجب الخضوع إلى عملية مراجعة التطبيقات وطلب الحصول على اعتماد لما يلي:
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" } ] }