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

تضمين منشورات Instagram على موقع ويب باستخدام oEmbed

تعيد نقطة النهاية (endpoint) الخاصة بـ Instagram oEmbed من Meta، وهي GET /instagram_oembed?url=<POST_URL>، كود HTML يضمّن منشورًا عامًا أو Reel على صفحة ويب، مع الحقول version وprovider_name وprovider_url وtype وwidth. ومنذ 15 مايو 2026 يمكن استدعاؤها دون رمز الوصول (token)، ويحمّل كود HTML ملف embed.js من Instagram لرسم المنشور.

تعيد easyCoexistence رابط كل منشور متصل على Instagram عبر list_social_posts، جاهزًا لتمريره إلى oEmbed، وتتيح لـ Claude أو ChatGPT أو لشيفرتك الخاصة نشر المنشورات وجدولتها والرد على التعليقات والرسائل المباشرة على الحساب عبر واجهة Meta الرسمية.

15 May 2026

منذ هذا التاريخ، يمكن استدعاء واجهة برمجة التطبيقات (API) الخاصة بـ Instagram oEmbed من Meta دون رمز وصول، في كل الإصدارات.

1,000/hour

عدد الطلبات في الساعة الذي يسمح به دليل oEmbed من Meta.

320 to 658

النطاق الذي يقبله المعامل maxwidth، أما maxheight فغير مدعوم.

3 Nov 2025

أُزيلت الحقول author_name وauthor_url وحقول الصورة المصغّرة من استجابات Instagram oEmbed في جميع إصدارات API.

Stories

القصص غير مدعومة في نقطة النهاية، ولا المنشورات من الحسابات الخاصة أو غير النشطة أو المقيّدة بالعمر.

كيف تعمل نقطة النهاية Instagram oEmbed؟

ترسل عنوان URL لمنشور عام فتحصل على كود HTML الذي يعرضه. تعمل نقطة النهاية على المضيف الرئيسي لـ Meta Graph API، وهو المضيف نفسه الذي تستخدمه استدعاءات Facebook Login، لا على graph.instagram.com. والاستجابة كائن JSON صغير يُدرج حقله html في الصفحة كما هو.

A request and its response
GET /instagram_oembed?url=https://www.instagram.com/p/<SHORTCODE>/

{
  "version": "1.0",
  "provider_name": "Instagram",
  "provider_url": "https://www.instagram.com/",
  "type": "rich",
  "width": 658,
  "html": "<EMBED_HTML>"
}

ما عناوين URL التي تقبلها؟

ثلاثة أشكال، كما يسردها دليل Meta لمعامل url، ويمكن إرسالها كما هي أو مرمّزة بصيغة URL. يُظهر طلبا النموذج في الدليل شكلًا من كل نوع:

  • منشورات الصورة الواحدة والألبومات: https://www.instagram.com/p/{media-shortcode}/
  • الفيديوهات وReels: https://www.instagram.com/reel/{media-shortcode}/
  • الملفات الشخصية: https://www.instagram.com/{username}

هل تحتاج إلى رمز وصول؟

لا، فمنذ 15 مايو 2026، حين أعلن سجل التغييرات لدى Meta أن واجهة Instagram oEmbed أصبحت قابلة للاستدعاء دون رمز. قبل ذلك كانت التطبيقات تحتاج إلى ميزة Meta oEmbed Read عبر مراجعة التطبيق (App Review) ورمز على كل استدعاء، ولا يزال الوصول القائم على الرمز يعمل. يسمح دليل oEmbed من Meta بما يصل إلى 1,000 طلب في الساعة، وذكر إعلان Meta عن الوصول دون رمز أن التطبيقات التي تستخدم الرموز قد تحصل على حدود معدل أعلى.

ما المعاملات التي تقبلها؟

أربعة معاملات إلى جانب url، من دليل Meta ومرجعه:

  • maxwidth: من 320 إلى 658؛ التضمين متجاوب بخلاف ذلك، ولا يُدعم maxheight.
  • hidecaption: القيمة true تخفي تعليق المنشور، وهي false افتراضيًا.
  • omitscript: القيمة true تحذف السكربت من كود HTML، للصفحات التي تحمّل embed.js مرة واحدة بنفسها وتستدعي instgrm.Embeds.process().
  • fields: يقصر الاستجابة على الحقول المذكورة.

ماذا تحتوي الاستجابة؟

ستة حقول افتراضية: html، وهو الكود المراد عرضه؛ وversion، وقيمته دائمًا 1.0؛ وprovider_name وprovider_url، واللذان يسميان Instagram؛ وtype، وهو نوع مورد oEmbed؛ وwidth، بالبكسل. أزالت Meta الحقول author_name وauthor_url وthumbnail_url وthumbnail_width وthumbnail_height من استجابات منشورات Instagram في جميع إصدارات API في 3 نوفمبر 2025. أما المنشورات الصادرة عن حسابك أنت، فما زالت واجهة media edge تعيد username وpermalink وthumbnail_url.

ما الذي لا يمكن تضمينه؟

يسرد دليل Meta ما تستثنيه نقطة النهاية، وقاعدة واحدة بشأن استخدامها:

  • المنشورات من الحسابات الخاصة وغير النشطة والمقيّدة بالعمر.
  • الحسابات التي أوقفت التضمين.
  • القصص، والصفحات التي تعرض التضمين داخل Shadow DOM.
  • أي استخدام يتجاوز العرض في الواجهة الأمامية: تحظر Meta بشدة استخدام بيانات نقطة النهاية أو محتواها لأغراض أخرى.

كيف تضمّن منشورات حسابك؟

خذ الرابط الدائم (permalink) لكل منشور ومرره بوصفه url. عبر easyCoexistence، تعيد الأداة list_social_posts أحدث منشورات الحساب المتصل مع روابطها الدائمة، وذلك من Claude أو ChatGPT أو من شيفرتك الخاصة. وبما أن استدعاء oEmbed لا يحتاج إلى رمز، يمكن لموقعك إجراؤه مباشرة.

الأخطاء الشائعة

  • إرسال رابط قصة. نقطة النهاية من Meta لا تدعم القصص، لذا ضمّن منشورًا أو Reel.
  • قراءة thumbnail_url من الاستجابة. أزالته Meta مع author_name وحقول الصورة المصغّرة الأخرى في 3 نوفمبر 2025.
  • ضبط maxwidth أقل من 320 أو أكبر من 658. تقبل Meta القيم في هذا النطاق فقط، ولا تقبل maxheight أصلًا.
  • تحميل embed.js مع كل تضمين. عند ضبط omitscript على true، حمّل السكربت مرة واحدة واستدعِ instgrm.Embeds.process().
إنجاز ذلك باستخدام EasyCoexistence

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

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

هل يمكنني تضمين Reel من Instagram؟

نعم. مرّر رابطه https://www.instagram.com/reel/{media-shortcode}/، فتعيد نقطة النهاية كود HTML للتضمين.

هل تضمين Instagram متجاوب؟

نعم. يقول دليل Meta إن التضمين متجاوب، وإن maxwidth يحدد أقصى عرض يصل إليه.

هل يمكنني تضمين ملف Instagram شخصي؟

نعم. يذكر دليل Meta روابط الملفات الشخصية، https://www.instagram.com/{username}، ضمن الصيغ التي يقبلها معامل url.

هل يمكنني استخدام بيانات oEmbed في التحليلات؟

لا. تسمح Meta باستخدام نقطة النهاية فقط لعرض المنشور في صفحة أو تطبيق، وتحظر أي استخدام آخر لبياناتها ومحتواها.

تابع القراءة

الحصول على منشورات حساب Instagram عبر واجهة برمجة التطبيقات (API)كيف تسرد API منشورات الحساب بـ GET /<IG_ID>/media: الحقول، وعناصر الكاروسيل، والتصفح بالمؤشر والتاريخ، وخلاصة لموقع.ما هي Instagram Graph API؟ واجهة Instagram API في 2026Instagram Graph API في 2026: واجهة Meta لـ Instagram بالتسجيل عبر Instagram أو Facebook أو Unified Login، وما تغطيه والحسابات التي تخدمها.إيقاف واجهة Instagram Basic Display API: ما الذي انتهى وكيف تنتقلتوقفت واجهة Instagram Basic Display API في 4 ديسمبر 2024. ما كانت تفعله، وما حل محلها لحسابات الأعمال والمبدعين، وكيفية نقل التطبيق.أي حسابات Instagram تعمل مع واجهة برمجة التطبيقات (API): تجاري أو منشئ أو شخصييعمل API من Instagram مع الحسابات الاحترافية، التجارية أو المنشئ. أيهما تختار، وما الذي يتغير عند التحويل، وكيف تحوّل الحساب من التطبيق.ما الذي تستطيع Instagram API فعله في 2026، وما الذي يبقى داخل التطبيقما تتيحه Instagram API في 2026 عبر Instagram Login: النشر والتعليقات والرسائل المباشرة والإحصاءات والإشارات، وما يبقى داخل التطبيق من الوصف إلى الموسيقى.

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

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

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

تم التحقق في