الحصول على منشورات حساب Instagram عبر واجهة برمجة التطبيقات (API)
يعيد GET /<IG_ID>/media منشورات حساب Instagram المهني على هيئة كائنات IG Media، بحد أقصاه 10,000 منشور من الأحدث إنشاءً. اطلب حقولاً مثل id، media_type، media_url، permalink، thumbnail_url و timestamp، واقرأ عناصر الكاروسيل عبر children. تتضمن الاستجابات مؤشّري تصفح هما before و after، ويحصر since و until النتائج بالتاريخ. ويكون عنوان الطلب graph.instagram.com عند استخدام Instagram Login.
يسرد easyCoexistence منشورات حساب Instagram المتصل عبر list_social_posts، من 1 إلى 100 في المرة، من Claude أو ChatGPT أو من كودك الخاص، عبر واجهة API الرسمية من Meta مع إضافة الرمز.
أقصى عدد من أحدث الوسائط يعيده media edge، وفق مرجع Meta لـ IG User Media.
معاملات التصفح الزمني للـ media edge، وتقبل طوابع Unix الزمنية أو قيم strtotime.
مكان قراءة القصص: لا يعيد media edge وسائط القصص.
نوع الوسائط الذي يعيد thumbnail_url، وهو عنوان URL لصورة المعاينة المصغّرة للوسائط.
كيف توصي Meta بالتعامل مع media_url، الذي تحذفه في بعض الفيديوهات؛ استخدم permalink أو thumbnail_url بديلاً.
كيف تحصل على منشورات الحساب؟
بطلب GET إلى media edge للحساب مع تسمية الحقول المطلوبة؛ فبلا fields يعيد مثال Meta المعرّف id لكل منشور فقط. مع Instagram Login يُرسل الطلب إلى graph.instagram.com باستخدام رمز الوصول (token) من نوع Instagram User الذي يحمل صلاحية instagram_business_basic، وتسرد الاستجابة المنشورات في data، مع كائن paging للصفحة التالية.
GET https://graph.instagram.com/<IG_ID>/media
?fields=id,media_type,media_url,permalink,thumbnail_url,timestamp
&limit=25
&access_token=<ACCESS_TOKEN>
{
"data": [
{
"id": "<IG_MEDIA_ID>",
"media_type": "IMAGE",
"media_url": "<CDN_URL>",
"permalink": "https://www.instagram.com/p/<SHORTCODE>/",
"timestamp": "2026-10-30T14:02:11+0000"
}
],
"paging": {
"cursors": { "before": "<CURSOR>", "after": "<CURSOR>" },
"next": "<NEXT_PAGE_URL>"
}
}ما الحقول التي يمكن أن يعيدها كل منشور؟
هذه حقول كائن IG Media المذكورة في مرجع Meta، فاطلب منها ما تستخدمه فقط. ينتهي صفّا caption و media_product_type في ذلك المرجع بالملاحظة Available for Instagram API with Facebook Login only، لذا تحقق منهما مع إعدادك قبل الاعتماد عليهما:
كيف يعمل التصفح؟
بالمؤشرات (cursors). يحمل كائن paging مؤشّري before و after، وعنوان next URL طالما بقيت نتائج؛ ويطلب دليل Meta Graph API التوقف حين يختفي next، لأن الصفحة قد تحوي عناصر أقل مما يطلبه limit. ويتيح media edge أيضاً التصفح بالوقت: تقبل since و until طوابع Unix أو قيم strtotime، وتحصر النتائج في هذا النطاق.
كيف تقرأ صور الكاروسيل وفيديوهاته؟
عبر children edge. المنشور الذي يكون media_type فيه CAROUSEL_ALBUM يسرد عناصره بالطلب GET /<IG_MEDIA_ID>/children، بالرمز نفسه والصلاحية نفسها كـ media edge، وكل عنصر كائن IG Media له id و media_type و media_url خاصة به. وتنبّه Meta إلى أن بعض الحقول، ومنها permalink، لا يمكن استخدامها مع الصور داخل الألبوم.
GET https://graph.instagram.com/<IG_MEDIA_ID>/children
?fields=id,media_type,media_url
&access_token=<ACCESS_TOKEN>لماذا لا يظهر media_url في بعض المنشورات؟
تحذفه Meta من وسائط الفيديو التي تحتوي على صوت محمي بحقوق النشر أو مرخّص، بما فيها المقاطع من مكتبة الصوتيات في Instagram، وكذلك الوسائط التي عُلّمت بانتهاك حقوق النشر، وذلك حتى في منشورات الحساب نفسه. ويقول مرجعها إن media_url اختياري، فاستخدم permalink أو thumbnail_url بديلاً. ويمكن قراءة البث المباشر (Live) فقط أثناء بثّه.
كيف تعرض المنشورات على موقع إلكتروني؟
من خادمك، باستخدام long-lived token الخاص بالحساب، وهو صالح لـ 60 يوماً ويجب تجديده قبل انتهائه. اربط كل صورة مصغّرة بـ permalink الخاص بها، وحدّث القائمة وفق جدول زمني: تقدّم Meta الوسائط عبر عناوين CDN تراعي الخصوصية، وتتوقف عن إعادة الملف بعد حذف المحتوى أو انتهاء صلاحيته. ولعرض المنشور كما يرسمه Instagram، مرّر permalink الخاص به إلى نقطة النهاية (endpoint) oEmbed بدلاً من ذلك.
كيف تعرض المنشورات عبر easyCoexistence؟
بالأداة list_social_posts، التي تأخذ account_id وحداً limit من 1 إلى 100، والافتراضي 25، وتعيد أحدث منشورات الحساب مع معرّفاتها وأنواع وسائطها وروابط وسائطها وصورها المصغّرة وpermalink وطوابعها الزمنية وعدد الإعجابات والتعليقات. تقرأ أحدث المنشورات، حتى 100، وليس لها مؤشر (cursor) للصفحات التالية أو لحقول أخرى.
الأخطاء الشائعة
- البحث عن Stories داخل media edge. تستبعدها Meta منه، ويعيدها GET /<IG_ID>/stories خلال الساعات الـ24 التي تبقى فيها.
- بناء خلاصة اعتماداً على media_url وحده. تحذفه Meta في بعض الفيديوهات، فأبقِ permalink أو thumbnail_url بديلاً احتياطياً.
- طلب permalink لعناصر الكاروسيل. لا تعيده Meta للصور داخل الألبوم، فاربط المحتوى بالمنشور الأم.
- اعتبار الصفحة القصيرة الأخيرة. قد تحوي الصفحة عناصر أقل من limit؛ توقف فقط عندما لا يوجد next في التصفح.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
عدد المنشورات التي تعيدها Instagram API؟
حتى 10,000 من أحدثها، صفحةً تلو أخرى من media edge. وتأتي القصص من stories edge المنفصل ما دامت متاحة.
هل يتضمن media edge الريلز؟
نعم. الريل كائن IG Media مثل الصورة، ويُبلَّغ عنه بالنوع media_type VIDEO؛ أما ما يستبعده media edge فهو القصص.
هل يمكنني الحصول على منشورات حساب آخر؟
ليس من media edge، لأنه يقرأ الحساب الذي يحمل الرمز. أما Business Discovery فيُرجع منشورات حساب تجاري أو منشئ آخر، وذلك في إعداد Facebook Login أو Unified Login، وهو ما لا يفعله media edge.
لماذا توقف عنوان media_url قديم عن العمل؟
عناوين CDN التابعة لـ Meta تراعي الخصوصية، فتتوقف عن إعادة الوسائط بعد حذف المحتوى أو انتهاء صلاحيته، لذا اطلب عناوين حديثة كلما احتجت إليها.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في