تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

واجهة برمجة التطبيقات (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 الخاصة بك فور وصولها.

30

الهاشتاغات الفريدة التي يمكن لحساب نشاط تجاري أو منشئ محتوى الاستعلام عنها خلال فترة 7 أيام متحركة.

24 hours

يعيد recent_media فقط الوسائط المنشورة خلال 24 ساعة من الاستعلام.

50

أكبر عدد من النتائج في الصفحة الواحدة من top_media، التي تُتصفَّح بمؤشر after وحده.

Not supported

البحث بالهاشتاغ عبر Instagram API مع Instagram Login، في مقارنة Meta بين الإعدادات الثلاثة.

Static

معرّفات الهاشتاغات ثابتة وعامة: يحتفظ الهاشتاغ بالمعرّف نفسه لكل تطبيق ومستخدم.

كيف يعمل البحث بالهاشتاغ؟

على خطوتين، تُنفَّذان نيابةً عن حساب نشاط تجاري أو منشئ محتوى في Instagram يوضع معرّفه في user_id. يعيد GET /ig_hashtag_search، مع ضبط q على اسم الهاشتاغ، معرّفه. وتقول Meta إن هذا المعرّف ثابت وعام، لذا يمكن تخزينه. ثم تعرض GET /<HASHTAG_ID>/top_media أو /recent_media، مع user_id وfields، المنشورات.

Finding a hashtag's ID, then its recent posts
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 إلى أن البحث بالهاشتاغ غير مدعوم في هذا الإعداد.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويتناقص السعر مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

هل يمكن البحث عن الهاشتاغات عبر Instagram API من دون موافقة مراجعة التطبيق؟

لا. تشترط Meta موافقة مراجعة التطبيق على ميزة Instagram Public Content Access وعلى إذن instagram_basic قبل أن يستطيع التطبيق استدعاء البحث بالهاشتاغ.

هل يمكنني معرفة من نشر باستخدام هاشتاغ معيّن؟

ليس باسم المستخدم، لأن Meta لا تُدرجه في نتائج الهاشتاغات. يفتح كل منشور على Instagram من خلال permalink الخاص به.

هل تشمل نتائج البحث بالهاشتاغ القصص؟

لا. لا تدعم Meta الهاشتاغات في القصص، ويعيد المساران صوراً وفيديوهات عامة فقط.

هل يُحتسب الاستعلام عن الهاشتاغ نفسه مرتين إذا كرّرته؟

لا. الاستعلامات المتكررة خلال أيامه السبعة لا تُحتسب من الـ30 ولا تعيد ضبط مؤقت الهاشتاغ.

تابع القراءة

Instagram Business Discovery: قراءة منشورات حساب آخر وعدد متابعيهكيف يقرأ Business Discovery في Instagram عدد متابعي حساب تجاري أو منشئ آخر وملفه ومنشوراته باسم المستخدم، وتسجيل الدخول الذي يحتاجه.إشارات @mentions على Instagram عبر API: استقبالها والرد عليهاكيف تصل إشارات @ على Instagram عبر API عبر webhook التعليقات مع Instagram Login، وكيفية الرد عليها في التعليقات والتسميات التوضيحية.الحصول على منشورات حساب Instagram عبر واجهة برمجة التطبيقات (API)كيف تسرد API منشورات الحساب بـ GET /<IG_ID>/media: الحقول، وعناصر الكاروسيل، والتصفح بالمؤشر والتاريخ، وخلاصة لموقع.وسم الأشخاص وإضافة موقع إلى منشور Instagram عبر APIشرح وسم الأشخاص بـ user_tags وإضافة مكان بـ location_id في Instagram API: المنشورات التي تقبلهما، وإحداثيات x وy، وكيفية العثور على الموقع.حدود معدل Instagram API: الاستدعاءات خلال 24 ساعة وإنتاجية الرسائل المباشرة (DM)حدود معدل Instagram API: 4,800 استدعاء لكل ظهور كل 24 ساعة، و100 رسالة مباشرة في الثانية، و750 ردًا خاصًا في الساعة، والخطأ 80002.أذونات واجهة برمجة التطبيقات (API) في Instagram: النطاقات وراء كل ميزةالأذونات التي تستخدمها Instagram API مع تسجيل الدخول عبر Instagram، من instagram_business_basic إلى manage_insights، وأي ميزة تحتاج أيّاً منها.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في