ما هي Instagram Graph API؟ واجهة Instagram API في 2026
Instagram Graph API هي واجهة Instagram البرمجية من Meta، أي مجموعة من واجهات برمجة التطبيقات (API) لحسابات Instagram الاحترافية، التجارية أو حسابات المنشئين، التي لا تزال عناوين مرجعها تحمل اسم Graph API. تُوثّق Meta اليوم ثلاثة إعدادات: واجهة Instagram API مع تسجيل Instagram التي تستدعي graph.instagram.com، ومع تسجيل Facebook، ومع Unified Login، وهي الموصى بها للتكاملات الجديدة. تستخدمها التطبيقات للنشر، وإدارة التعليقات، والرد على الرسائل المباشرة، وقراءة الإحصاءات.
تعمل easyCoexistence على Instagram API مع Instagram Login: يسجّل مالك الحساب الدخول بـ Instagram مرة واحدة، ويتولى Claude أو ChatGPT أو منصتك الخاصة نشر المنشورات وجدولتها، والرد على التعليقات والرسائل المباشرة، وقراءة الإحصاءات عبر واجهة Meta الرسمية، مع مراقبة كل اتصال 24/7.
إعدادات Instagram API في نظرة Meta العامة: Unified Login، Instagram Login، و Facebook Login.
إطلاق Instagram API مع تسجيل Instagram: لا يُشترط ربط صفحة، وتُرسل الطلبات إلى graph.instagram.com.
أوقفت Meta واجهة Instagram Basic Display API، ويذكر سجل تغييراتها أن الطلبات إليها تُعيد رسالة خطأ.
الإعداد الذي توصي به Meta للتكاملات الجديدة، وهو الإعداد الوحيد الذي تُطلق فيه ميزات Instagram API الجديدة.
نوع الحساب الذي تخدمه منصة Instagram: حساب تجاري أو حساب منشئ.
ماذا تسمّي Meta واجهة Instagram Graph API الآن؟
منصة Instagram (Instagram Platform)، وتصفها نظرة Meta العامة بأنها مجموعة واجهات برمجة للحسابات الاحترافية في Instagram، مقسّمة إلى ثلاثة إعدادات بحسب طريقة تسجيل دخول مالك الحساب. يبقى اسم Graph API في عناوين المرجع، تحت instagram-graph-api، وفي ملاحظة النظرة العامة بأن ميزة Instagram Public Content Access تفتح نقاط نهاية Hashtag Search في Instagram Graph API. يصف المرجع العُقد (nodes) مثل IG User وIG Media وحقولها التي تُطلب بـ fields=، والحواف (edges) مثل /media و/stories.
ما الإعدادات التي توثّقها Meta؟
ثلاثة. تختلف في طريقة تسجيل دخول مالك الحساب، والرمز المميز الذي يتلقاه التطبيق، والمضيف الذي يستدعيه، ويخدم كل منها الحسابات الاحترافية نفسها. توصي نظرة Meta العامة باستخدام Unified Login في التكاملات الجديدة، وتُبقي على Instagram Login و Facebook Login للتكاملات القائمة:
ماذا تغطي الواجهة؟
تجيب نظرة Meta العامة عن كل قدرة على حدة. يُعلَّم Unified Login بعبارة Supported في كل صف، ويختلف الإعدادان الآخران كما يلي، ويضيف دليل Business Discovery من Meta أن البحث عن حسابات أخرى يعمل مع Facebook Login و Unified Login:
| Instagram Login | Facebook Login | |
|---|---|---|
| Content publishing | Supported | Supported |
| Comment moderation | Supported | Supported |
| Mentions | Supported | Supported |
| Insights | Supported | Supported |
| Messaging | Supported | Supported, through a separate messaging API |
| Hashtag search | Not supported | Supported |
| Business Discovery | Not listed | Supported |
| Product tagging | Not supported | Supported |
| Partnership ads | Not supported | Supported |
ما علاقتها بواجهة Basic Display API؟
لم تعد Basic Display موجودة. أوقفتها Meta في 4 ديسمبر 2024، ويذكر سجل تغييراتها أن الطلبات إليها تُعيد رسالة خطأ، وتوصي Meta بالانتقال إلى واجهة Instagram API. وقد أُطلق إعداد Instagram Login في تلك الواجهة في 23 يوليو 2024، فأسقط الصفحة المرتبطة التي كانت الإعدادات السابقة تشترطها. أما الحسابات الشخصية فلا تملك واجهة برمجية، إذ تشترط نظرة Meta العامة حسابًا احترافيًا، تجاريًا أو حساب منشئ.
ما الحسابات التي تخدمها؟
حسابات Instagram الاحترافية، وتقول Meta إنها قد تمثّل نشاطًا تجاريًا أو منشئًا. يخدم Instagram Login و Unified Login الحسابات غير المرتبطة بصفحة، بينما يخدم Facebook Login الحسابات المرتبطة بصفحة، ويجب أن يكون الشخص الذي يسجّل الدخول قادرًا على تنفيذ مهام تعادل صلاحيات المسؤول على تلك الصفحة. يغطي Standard Access الحسابات التي تملكها أو تديرها، وتحتاج خدمة الآخرين إلى Advanced Access عبر App Review و Business Verification.
كيف يبدو أول استدعاء؟
مع Instagram Login، وبعد أن يسجّل مالك الحساب الدخول ويحمل التطبيق رمز الوصول (token)، يعيد الطلب GET /me مع الحقلين user_id و username معرّفَ الحساب IG_ID، وتقول Meta في دليلها إنه المعرّف نفسه في إشعارات خطاف الويب (webhook) الخاصة بها. ثم يسرد الطلب GET /<IG_ID>/media منشوراته بمعرّفها، مع مؤشرات before و after للانتقال إلى الصفحة التالية.
GET https://graph.instagram.com/me
?fields=user_id,username
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<IG_ID>/media
?access_token=<ACCESS_TOKEN>كيف تستخدمها عبر easyCoexistence؟
تربط easyCoexistence الحسابات عبر Instagram API مع Instagram Login، وتحتفظ بتطبيق Meta، فيسجّل مالك الحساب الدخول بـ Instagram ويوافق على الصلاحيات. ثم يستدعي Claude أو ChatGPT أو كودك الخاص أدوات مثل publish_instagram_post و list_social_posts و get_social_insights، وهي تضيف token الحساب؛ ويعيد get_social_credentials معرّف الحساب وقاعدة API الخاصة به، ولا يعيد الـ token أبدًا.
الأخطاء الشائعة
- اتباع دليل Facebook Login برمز Instagram Login. تختلف المضيفات والرموز وأسماء الصلاحيات بين الإعدادات، فطابق الدليل مع الإعداد الذي يستخدمه التطبيق.
- توجيه الواجهة إلى حساب شخصي. تخدم إعدادات Meta الحسابات الاحترافية، فبدّل الحساب إلى تجاري أو منشئ في تطبيق Instagram أولًا.
- نسخ أمثلة Basic Display. أُعيدت أخطاء من نقاط نهايتها منذ 4 ديسمبر 2024، فاقرأ الحساب بـ GET /me ومنشوراته عبر /<IG_ID>/media بدلًا منها.
- التخطيط للبحث بالهاشتاغ عبر Instagram Login. تُعلّم نظرة Meta العامة هذه الميزة بأنها غير مدعومة هناك، وهي تحتاج إلى Facebook Login أو Unified Login.
من US$ 9 لكل اتصال شهريًا، ينخفض إلى US$ 0.75 كلما أضفت اتصالات، وتتوفر أول 3 أيام مجانًا.
الأسئلة الشائعة
هل Instagram Graph API هي نفسها Instagram API؟
نعم. تسمّيها وثائق Meta الآن Instagram API، في إعدادات تُسمّى باسم تسجيل الدخول الذي تستخدمه، وتُبقي مسار instagram-graph-api في عناوين المرجع.
هل تحتاج Instagram API إلى صفحة مرتبطة؟
لا، مع Instagram Login أو Unified Login. Facebook Login هو الإعداد الذي يشترط ربط الحساب الاحترافي بصفحة.
أي إعداد ينبغي أن يستخدمه تكامل Instagram جديد؟
Unified Login، بتوصية من Meta، وتُطلق Meta ميزات Instagram API الجديدة هناك فقط. ويقول دليل الترحيل من Meta إن التطبيقات المنشأة حديثًا لا تستطيع إعداد Instagram Login، بينما تواصل التكاملات القائمة على Instagram Login عملها دون تاريخ انتهاء معلن.
كم تكلّف easyCoexistence لحساب Instagram؟
كل حساب Instagram هو اتصال واحد، ويُحتسب من US$ 9 إلى US$ 0.75 شهريًا بحسب عدد اتصالاتك، وأول 3 أيام مجانًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في