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

פרסום Reels ב-Instagram דרך ה-API

ה-API של Instagram מפרסם Reel מקובץ MOV או MP4 בכתובת ה-URL ציבורית: יוצרים קונטיינר עם media_type REELS, ממתינים לסיום עיבוד הווידאו על ידי Meta, ואז מפרסמים. Reel יכול להיות באורך של 3 שניות עד 15 דקות ועד 300 MB, ו-Meta ממליצה על פריים של 9:16 כדי להימנע מחיתוך או שטחים ריקים.

easyCoexistence מפרסם Reels עם publish_instagram_post מתוך Claude, ChatGPT או מהקוד שלכם: נותנים לה את כתובת ה-URL של הווידאו ואת הכיתוב, וכל עוד הווידאו עדיין מעובד, היא משלימה את הפרסום בעצמה.

15 min

הסרטון הארוך ביותר שה-API מפרסם; הקצר ביותר הוא 3 שניות.

300 MB

גודל הקובץ המקסימלי של Reel: MOV או MP4 עם וידאו H.264 או HEVC ואודיו AAC

1 min

תדירות הבדיקה של סטטוס קונטיינר בעיבוד שמציעה Meta, ולא יותר מ-5 דקות.

24 hours

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

כיצד מפרסמים Reel?

בשלושה שלבים. ראשית, שולחים POST אל /<IG_ID>/media עם media_type שמוגדר ל-REELS, video_url שמצביע על הקובץ ובמידת הצורך כיתוב; Meta מושכת את הווידאו ומחזירה את מזהה הקונטיינר. שנית, ממתינים לסיום העיבוד של Instagram ובודקים את status_code של הקונטיינר. שלישית, שולחים POST אל /<IG_ID>/media_publish עם creation_id שמכיל את מזהה הקונטיינר, והתגובה כוללת את מזהה המדיה החדש.

Meta מתעדת העלאה ניתנת להמשכה, שיכולה לשלוח קובץ ממחשב, אבל רק להגדרות שנבנו על Facebook Login for Business, כולל Unified Login, ולא על הגדרות אחרות. עם Instagram Login, הווידאו תמיד מגיע מכתובת ה-URL ציבורית.

אילו דרישות יש לווידאו?

המפרט של Meta ל-Reels, שקובץ חייב לעמוד בו לפני ש-Instagram יעבד אותו:

  • קונטיינר: MOV או MP4 (MPEG-4 Part 14), ללא edit lists, עם moov atom בתחילת הקובץ.
  • וידאו: H.264 או HEVC, סריקה פרוגרסיבית, closed GOP, דגימת כרומה 4:2:0, עד 25 Mbps, עד 1920 פיקסלים ברוחב, ו-23 עד 60 פריימים לשנייה.
  • אודיו: AAC בקצב של 128 kbps, עד 48 kHz, מונו או סטריאו.
  • יחס גובה-רוחב: כל יחס בין 0.01:1 ל-10:1, כאשר 9:16 מומלץ.
  • אורך וגודל: 300 MB לכל היותר, ו-3 שניות עד 15 דקות.

מה קורה בזמן עיבוד הווידאו?

status_code של הקונטיינר נשאר IN_PROGRESS עד ש-Instagram מסיים לעבד את הווידאו, ואז עובר ל-FINISHED, ורק אז אפשר לפרסם אותו. פרסום לפני כן נכשל עם קוד 9007 ו-subcode 2207027, שמשמעותו להמתין ולא לתקן. Meta ממליצה לבדוק את הסטטוס פעם בדקה, ולא יותר מ-5 דקות.

ERROR פירושו שהקונטיינר לא הצליח להשלים את העיבוד, ו-EXPIRED פירושו שהוא נשאר ללא פרסום 24 שעות; שני המקרים דורשים קונטיינר חדש. PUBLISHED פירושו שה-Reel כבר באוויר.

אילו אפשרויות Reel מציע ה-API?

מעבר לווידאו ולכיתוב, קונטיינר ה-Reel של Meta מקבל את הפרמטרים הבאים:

  • share_to_feed: true מאפשר ל-Reel להופיע גם בפיד, בנוסף ללשונית Reels; false משאיר אותו בלשונית Reels בלבד. אף ערך לא מבטיח מקום בלשונית הזו.
  • cover_url: קובץ JPEG של עד 8 MB, שמשמש כשער לשונית Reels, חתוך למרכז בפורמט 9:16, וכריבוע כשהוא משותף לפיד.
  • thumb_offset: הפריים, במילישניות, ששימש כתמונה ממוזערת כשאין שער; 0 הוא הפריים הראשון.
  • audio_name: שם לאודיו של ה-Reel, שניתן להגדיר רק פעם אחת.
  • trial_params: מפרסם Reel ניסיוני, שמשותף רק לאנשים שאינם עוקבים אחרי החשבון, עד שהוא עובר לשלב הרגיל.

אילו כללים נוספים חלים על Reel?

כמה כללים חלים על Reel מרגע יצירת הקונטיינר שלו.

  • Reel לא יכול להיות פריט בקרוסלה; הוא תמיד מפורסם בפני עצמו.
  • הגדרות הפרטיות של החשבון חלות בזמן הפרסום, ואם האפשרות Allow remixing פעילה, גם ה-Reel החדש יאפשר רימיקס.
  • תיוג מוזיקה זמין רק לאודיו מקורי.
  • כשקוראים אותו מאוחר יותר, ה-Reel מדווח media_type VIDEO, כמו כל וידאו אחר.
  • הוא נספר כפוסט אחד מתוך 100 הפוסטים שמתפרסמים דרך ה-API של החשבון ב-24 שעות.

אילו מדדים Reel מדווח?

דרך נקודת הקצה של תובנות המדיה, ה-Reel מדווח על reach, views, likes, comments, saved, shares, total_interactions ו-reposts, ועוד שלושה מדדים משלו: ig_reels_avg_watch_time, ig_reels_video_view_total_time ו-reels_skip_rate, שהוא שיעור הצפיות שדולגו בתוך 3 השניות הראשונות. המדדים likes, comments ו-views סופרים רק פעילות אורגנית, והנתונים שמאחוריהם עשויים לפגר עד 48 שעות.

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

  • פרסום מיד עם יצירת הקונטיינר. ממתינים עד ש-status_code יציג FINISHED, אחרת הקריאה נכשלת עם subcode 2207027 שמציין עיבוד שעדיין לא הסתיים.
  • שליחת קובץ מסוג WebM או AVI. Reels חייבים להיות בפורמט MOV או MP4, אחרת Meta דוחה אותם עם קוד 352 ו-subcode 2207026, שמציין את סיבת הדחייה.
  • ציפייה שהפרמטר share_to_feed ישים את ה-Reel בלשונית Reels. הוא מוסיף רק את הפיד, ו-Instagram מחליט מה יוצג בלשונית Reels.
  • השארת קונטיינר ללא פרסום לאורך הלילה. הוא פג תוקף 24 שעות אחרי היצירה, ואז הפרסום דורש קונטיינר חדש.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

כמה ארוך יכול להיות Reel דרך ה-API?

קובץ MOV או MP4 שגודלו עד 300 MB, באורך של 3 שניות עד 15 דקות.

אפשר להעלות Reel מהמחשב שלי?

לא עם Instagram Login. ה-API מושך את הווידאו מכתובת ה-URL ציבורית, לכן צריך קודם להעלות את הקובץ למקום שנותן לו קישור ציבורי.

האם Reel שפורסם דרך ה-API מופיע גם בפיד?

כן, אפשרי. הפרמטר share_to_feed קובע אם ה-Reel יוכל להופיע גם בפיד, בנוסף ללשונית Reels.

למה פרסום Reel נכשל עם קוד 9007?

כי Instagram עדיין מעבד את הווידאו. בודקים את status_code של הקונטיינר ומפרסמים כשהוא מציג FINISHED; אין צורך לתקן דבר בבקשה.

המשיכו לקרוא

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

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

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

נבדק ב-