واجهة برمجة التطبيقات (API) للبحث بالهاشتاغ في Instagram: العثور على المنشورات حسب الهاشتاغ
يعثر البحث بالهاشتاغ في Instagram على الصور والفيديوهات العامة التي تحمل هاشتاغاً، عبر استدعاءين. يعيد GET /ig_hashtag_search، مع user_id وq، معرّف الهاشتاغ، ثم يعرض GET /<HASHTAG_ID>/top_media أكثر المنشورات شيوعاً، و/recent_media المنشورات المنشورة خلال آخر 24 ساعة. يمكن لحساب الاستعلام عن 30 هاشتاغاً فريداً خلال 7 أيام متحركة، باستخدام Facebook Login أو Unified Login.
يربط easyCoexistence حساب Instagram عبر Instagram Login، فيعمل Claude أو ChatGPT أو الشيفرة الخاصة بك على منشورات الحساب وتعليقاته وإشاراته وإحصاءاته عبر واجهة Meta الرسمية، ويمكن إرسال تعليقاته وإشاراته إلى endpoint الخاصة بك فور وصولها.
الهاشتاغات الفريدة التي يمكن لحساب نشاط تجاري أو منشئ محتوى الاستعلام عنها خلال فترة 7 أيام متحركة.
يعيد recent_media فقط الوسائط المنشورة خلال 24 ساعة من الاستعلام.
أكبر عدد من النتائج في الصفحة الواحدة من top_media، التي تُتصفَّح بمؤشر after وحده.
البحث بالهاشتاغ عبر Instagram API مع Instagram Login، في مقارنة Meta بين الإعدادات الثلاثة.
معرّفات الهاشتاغات ثابتة وعامة: يحتفظ الهاشتاغ بالمعرّف نفسه لكل تطبيق ومستخدم.
كيف يعمل البحث بالهاشتاغ؟
على خطوتين، تُنفَّذان نيابةً عن حساب نشاط تجاري أو منشئ محتوى في Instagram يوضع معرّفه في user_id. يعيد GET /ig_hashtag_search، مع ضبط q على اسم الهاشتاغ، معرّفه. وتقول Meta إن هذا المعرّف ثابت وعام، لذا يمكن تخزينه. ثم تعرض GET /<HASHTAG_ID>/top_media أو /recent_media، مع user_id وfields، المنشورات.
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee
{ "data": [ { "id": "<HASHTAG_ID>" } ] }
GET /<HASHTAG_ID>/recent_media
?user_id=<IG_ID>
&fields=id,media_type,permalink,timestamp,like_count,comments_countما الفرق بين top_media وrecent_media؟
يعيد top_media أكثر الصور والفيديوهات شيوعاً الموسومة بالهاشتاغ، وتقيس Meta الشيوع بمزيج من المشاهدات وتفاعل المشاهدين. ويعيد recent_media أحدث ما نُشر، ويقتصر على الوسائط المنشورة خلال 24 ساعة من الاستعلام، وتشير Meta إلى أن ردودها ليست دائماً مرتبة زمنياً. يعيد الاثنان الوسائط العامة فقط، ويستبعدان الوسائط المروّجة والمعززة والإعلانية، ويتصفحان النتائج 50 في كل مرة بمؤشر after.
ما الحقول التي تعود؟
حقول الوسائط التي تسردها مراجع Meta للمسارين، وهما يعيدان الصور والفيديوهات العامة فقط:
- id و
media_type(CAROUSEL_ALBUMأو IMAGE أو VIDEO) وpermalink وtimestamp. - caption و
comments_count، إضافة إلىlike_countإلا إذا أخفى المالك عدد الإعجابات. - children لوسائط الألبوم، و
media_urlللوسائط الأخرى، باستثناء الفيديوهات ذات الصوت المحمي بحقوق النشر أو المرخص. - لا يُعاد username: لا تسمح Meta بذلك على الوسائط التي يعيدها البحث بالهاشتاغ.
ما الحدود؟
تضع Meta الحدود لكل حساب ولكل هاشتاغ:
- 30 هاشتاغاً فريداً خلال 7 أيام متحركة. يُحتسب الهاشتاغ من أول استعلام عنه، والاستعلام عنه مجدداً خلال تلك المدة مجاني ولا يعيد ضبط مدة الأيام السبعة.
- جلب
top_mediaأوrecent_mediaيُحتسب استعلاماً عن الهاشتاغ، حتى عندما يكون معرّفه مخزَّناً مسبقاً. - يسرد GET /<
IG_ID>/recently_searched_hashtagsالهاشتاغات الفريدة التي بحث عنها الحساب في الأسبوع الحالي. - لا تُدعم الهاشتاغات في القصص والرموز التعبيرية في الاستعلامات، والهاشتاغات التي تعدّها Meta حساسة أو مسيئة تعيد خطأً عاماً.
- لا يمكن التعليق على الوسائط التي عُثر عليها بهذه الطريقة عبر API.
ما الذي يحتاجه البحث بالهاشتاغ؟
موافقة مراجعة التطبيق (App Review) على ميزة Instagram Public Content Access وإذن instagram_basic، وهما مطلوبان من Meta قبل أن يستطيع التطبيق استخدامه، إضافة إلى رمز الوصول (token) من Facebook Login لشخص يستطيع تنفيذ المهام على الصفحة المرتبطة، أو رمز Unified Login. ويدرج ملخص Meta البحث بالهاشتاغ على أنه غير مدعوم مع Instagram Login، وتخضع استدعاءاته لحدود معدل المنصة في Meta لا لميزانية الاستدعاءات لكل حساب في Instagram. وتشمل الاستخدامات المسموحة التي تذكرها Meta العثور على المحتوى من حملات الهاشتاغ الخاصة بك، وفهم المشاعر العامة تجاه علامتك التجارية، وتحديد المشاركين في المسابقات.
هل يمكن البحث عن الهاشتاغات عبر easyCoexistence؟
يربط easyCoexistence حساب Instagram عبر Instagram Login، وهو يصل إلى المنشورات والتعليقات والإشارات والإحصاءات الخاصة بالحساب المتصل. تقدّم Meta البحث بالهاشتاغ عبر Facebook Login وUnified Login فقط، لذا فهو خارج هذا الربط. أما ما يغطيه الربط فهو: منشورات الحساب الخاصة عبر list_social_posts، وتعليقاته وإشاراته، التي تُرسل إلى نقطة النهاية (endpoint) الخاصة بك فور وصولها.
الأخطاء الشائعة
- إنفاق الحصة الأسبوعية على الاختبارات. يُحتسب كل هاشتاغ جديد ضمن الـ30 خلال 7 أيام، ويُحتسب جلب وسائطه حتى مع وجود معرّف مخزَّن.
- طلب username في نتائج الهاشتاغ. لا تعيده Meta للوسائط التي يعثر عليها البحث بالهاشتاغ.
- قراءة recent_media كأرشيف. يغطي المنشورات خلال 24 ساعة قبل الاستعلام، وليس بترتيب زمني صارم.
- الاستدعاء برمز Instagram Login. تشير Meta إلى أن البحث بالهاشتاغ غير مدعوم في هذا الإعداد.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويتناقص السعر مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكن البحث عن الهاشتاغات عبر Instagram API من دون موافقة مراجعة التطبيق؟
لا. تشترط Meta موافقة مراجعة التطبيق على ميزة Instagram Public Content Access وعلى إذن instagram_basic قبل أن يستطيع التطبيق استدعاء البحث بالهاشتاغ.
هل يمكنني معرفة من نشر باستخدام هاشتاغ معيّن؟
ليس باسم المستخدم، لأن Meta لا تُدرجه في نتائج الهاشتاغات. يفتح كل منشور على Instagram من خلال permalink الخاص به.
هل تشمل نتائج البحث بالهاشتاغ القصص؟
لا. لا تدعم Meta الهاشتاغات في القصص، ويعيد المساران صوراً وفيديوهات عامة فقط.
هل يُحتسب الاستعلام عن الهاشتاغ نفسه مرتين إذا كرّرته؟
لا. الاستعلامات المتكررة خلال أيامه السبعة لا تُحتسب من الـ30 ولا تعيد ضبط مؤقت الهاشتاغ.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في