התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

פרסום סטוריז של Instagram דרך ה-API

ה-API של Instagram מפרסם סטורי מתמונה אחת או מסרטון אחד בכתובת ציבורית: יוצרים קונטיינר כאשר media_type הוא STORIES, ואז מפרסמים אותו. תמונות הן JPEG עד 8 MB, סרטונים באורך של 3 עד 60 שניות ועד 100 MB, Meta ממליצה על מסגרת 9:16, והסטורי נעלם אחרי 24 שעות, כמו באפליקציה.

easyCoexistence מפרסמת סטוריז של תמונה ושל וידאו עם publish_instagram_post מ-Claude, מ-ChatGPT או מהקוד שלכם, וניתן לתזמן אותם מהתור שלה.

60 s

הסרטון הארוך ביותר לסטורי שה-API מפרסם; הקצר ביותר הוא 3 שניות, והקובץ יכול להגיע ל-100 MB.

8 MB

התמונה הגדולה ביותר לסטורי, ושחייבת להיות JPEG.

24 hours

כמה זמן סטורי שפורסם נשאר מוצג לפני שפג תוקפו.

Under 5

ערכי מדד נמוכים מאוד לסטורי מוחזרים כקוד שגיאה 10, צופים לא מספיקים, במקום מספר.

איך מפרסמים סטורי?

בשתי הקריאות הרגילות לכל פוסט. POST /<IG_ID>/media כאשר media_type הוא STORIES ואחד מהשדות image_url או video_url, ואז POST /<IG_ID>/media_publish עם מזהה הקונטיינר. סטורי של וידאו עובר עיבוד קודם, ולכן status_code של הקונטיינר שלו צריך להציג FINISHED לפני הפרסום.

התיעוד של Meta מתאר כיתוב לתמונות, לסרטונים ולקרוסלות, לא לסטוריז, ולכן מילים שמיועדות לצופה שייכות לתוך התמונה או הסרטון עצמם.

אילו דרישות יש למדיה של סטורי?

Meta ממליצה על מסגרת 9:16 לתמונות ולסרטונים של סטוריז כאחד, כדי להימנע מחיתוך או משטח ריק.

  • תמונה: JPEG, עד 8 MB, בפרופיל צבע sRGB; מרחבי צבע אחרים מומרים.
  • וידאו: MOV או MP4 עם וידאו H.264 או HEVC ואודיו AAC, 23 עד 60 פריימים לשנייה, עד 1920 פיקסלים ברוחב ו-25 Mbps.
  • אורך וידאו: 3 עד 60 שניות, עם קובץ של עד 100 MB.
  • יחס תצוגה של וידאו: כל יחס בין 0.1:1 ל-10:1 מתקבל.

מה סטורי יכול לכלול?

את התמונה או הסרטון עצמם, ואזכורים של חשבונות אחרים: מאז יולי 2025 הפרמטר user_tags מתייג חשבונות ציבוריים בסטוריז של תמונה ושל וידאו, והקואורדינטות x ו-y הן אופציונליות. Meta אינה תומכת בפרסום מדבקות דרך ה-API, ולכן קישורים, סקרים ומיקומים נשארים באפליקציה.

מה קורה אחרי שסטורי מפורסם?

הוא נשאר מוצג 24 שעות ואז פג תוקפו, כמו באפליקציה. Meta מציגה סטוריז חיים ב-stories edge נפרד; רשימת המדיה של החשבון, GET /<IG_ID>/media, אינה כוללת אותם. כשקוראים בחזרה, media_type של סטורי הוא IMAGE או VIDEO, כמו בכל מדיה אחרת, ולכן מבחינים בין הסטוריז לבין שאר המדיה לפי המקום שבו מצאתם אותם, ולא לפי הסוג.

איך מגיעים תגובות ואזכורים?

כהודעות ישירות. תגובה לסטורי מגיעה לחשבון כהודעת DM בוובהוק (Webhook) של messages, עם מזהה הסטורי וכתובת ה-URL שלו, ופותחת את חלון 24 השעות הרגיל לתשובה. כשמישהו מזכיר את החשבון בסטורי שלו, גם זה מגיע כהודעה, עם קובץ מצורף מסוג story_mention. ה-Mentions API של Meta אינו מכסה סטוריז.

אילו מדדים סטורי מציג?

הגעה, צפיות, שיתופים, תגובות, עוקבים חדשים, ביקורים בפרופיל, פעילות בפרופיל, ניווט, לחיצות על קישורים, פרסומים מחדש וסך האינטראקציות, שנקראים דרך נקודת הקצה media insights. הם זמינים 24 שעות בלבד, וערך מתחת ל-5 מחזיר קוד שגיאה 10, צופים לא מספיקים, במקום מספר. תגובות של אנשים מאירופה וביפן אינן נכללות בספירה, וסטורי שנוצר בחשבון מאותם אזורים מדווח על 0 תגובות.

טעויות נפוצות

  • תכנון של מדבקת קישור. ה-API אינו מפרסם מדבקות, ולכן קישור צריך להגיע לאנשים בדרך אחרת, כמו תשובה בהודעת DM.
  • קריאת מדדי סטורי למחרת. הם זמינים 24 שעות בלבד, ולכן אספו אותם בזמן שהסטורי מוצג.
  • חיפוש סטורי שפורסם ברשימת המדיה של החשבון. סטוריז חיים מופיעים ב-stories edge נפרד.
  • פרסום סרטון לרוחב כסטורי. Meta ממליצה על 9:16, וצורות אחרות עלולות להציג שטח ריק או להיחתך.
עושים את זה עם EasyCoexistence

תגובות לסטורי מגיעות כהודעות DM, שאפשר להעביר לנקודת הקצה שלכם או לקבל עליהן מענה מאוטומציה. US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים חינם.

שאלות נפוצות

אפשר להוסיף מדבקת קישור לסטורי דרך ה-API?

לא. Meta אינה תומכת בפרסום מדבקות דרך ה-API, כולל קישורים, סקרים ומיקומים. אזכור של חשבון אחר בלי מדבקה נתמך.

איפה מופיע סטורי שפורסם ב-API?

ב-stories edge של החשבון, בזמן שהוא חי. GET /<IG_ID>/media אינו כולל סטוריז, וסטורי נקרא בחזרה כתמונה או כסרטון.

אפשר שיהיה לסטורי כיתוב דרך ה-API?

לא. התיעוד של Meta אינו מתאר כיתוב לסטוריז, והכלי publish_instagram_post שולח סטורי בלי כיתוב, ולכן מילים שמיועדות לצופה נכנסות לתוך התמונה או הסרטון עצמם.

כמה זמן זמינים מדדי סטורי?

24 שעות. Meta מאפשרת לקרוא מדדי סטורי רק לאורך פרק הזמן הזה, ולכן קראו אותם בזמן שהסטורי מוצג.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-