קבלת הפוסטים של חשבון 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 מגבילים את התוצאות לפי תאריך. עם Instagram Login הקריאה נשלחת אל הכתובת graph.instagram.com המיועדת לכך.
easyCoexistence מציג את הפוסטים של חשבון Instagram מחובר עם list_social_posts, 1 עד 100 בכל פעם, מ-Claude, מ-ChatGPT או מהקוד שלכם, דרך ה-API הרשמי של Meta, עם האסימון מצורף.
לפי התיעוד של Meta על מדיה של משתמש IG, נקודת הקצה media מחזירה עד מספר מרבי של פריטים.
נקודת הקצה media תומכת בדפדוף לפי זמן, עם חותמות זמן מסוג Unix או ערכי strtotime לבחירה.
היכן קוראים סטוריז: נקודת הקצה media לא מחזירה מדיה מסוג סטורי.
סוג המדיה שמחזיר את thumbnail_url, כתובת התמונה הממוזערת של המדיה.
איך Meta ממליצה לטפל ב-media_url, שהיא משמיטה בחלק מהסרטונים: נופלים אל permalink או אל תמונה ממוזערת.
איך מקבלים את הפוסטים של חשבון?
עם GET על נקודת הקצה media של החשבון, ומציינים את השדות שרוצים. אם לא מציינים שדות, לפי הדוגמה של Meta מוחזר רק המזהה id של כל פוסט. עם Instagram Login הבקשה נשלחת אל graph.instagram.com עם אסימון גישה של משתמש Instagram שמכיל את ההרשאה 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, ולכן כדאי לבדוק אותן מול ההגדרה שלכם לפני שסומכים עליהן:
איך עובד הדפדוף?
עם סמנים. אובייקט paging כולל סמני before וגם after, וכל עוד יש עוד תוצאות גם כתובת next. ההנחיה של Meta במדריך Graph API היא לעצור כשהשדה next כבר לא מופיע, כי עמוד יכול להחזיר פחות פריטים ממה שהפרמטר limit מבקש. נקודת הקצה media מתפצלת גם לפי זמן: הפרמטרים since וגם until מקבלים חותמות זמן מסוג Unix או ערכי strtotime, ומגבילים את התוצאות לטווח הזה.
איך קוראים את התמונות והסרטונים בקרוסלה?
דרך נקודת הקצה children. פוסט שסוג המדיה שלו הוא CAROUSEL_ALBUM מציג את פריטיו עם GET /<IG_MEDIA_ID>/children, באותו אסימון ובאותה הרשאה כמו נקודת הקצה media. כל פריט הוא אובייקט 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 כאופציונלי ולעבור לחלופה: קישור הפוסט או תמונה ממוזערת. סרטון Live אפשר לקרוא רק בזמן שהוא משודר.
איך מציגים את הפוסטים באתר?
מהשרת שלכם, עם אסימון הגישה לטווח ארוך, שתקף 60 יום ויש לרענן אותו לפני שפג תוקפו. מקשרים כל אריח אל permalink שלו, ומרעננים את הרשימה לפי לוח זמנים: Meta מגישה מדיה דרך כתובות CDN שמודעות לפרטיות, ומפסיקות להחזיר קובץ אחרי שהתוכן נמחק או פג תוקפו. כדי להציג פוסט כפי ש-Instagram מציגה אותו, שולחים את הקישור שלו לנקודת הקצה oEmbed במקום.
איך מציגים רשימת פוסטים דרך easyCoexistence?
עם list_social_posts, שמקבל את הפרמטרים account_id וגם limit בטווח שבין 1 ל-100, עם ברירת מחדל של 25. הוא מחזיר את הפוסטים האחרונים של החשבון עם המזהים, סוגי המדיה, כתובות המדיה, התמונות הממוזערות, הקישורים הישירים, חותמות הזמן ומספרי הלייקים והתגובות. הוא קורא את הפוסטים האחרונים, עד 100, ואין לו סמן לעמודים נוספים או לשדות אחרים.
טעויות נפוצות
- לחפש סטוריז בנקודת media. Meta משמיטה אותם; GET /<IG_ID>/stories מחזיר אותם במשך 24 השעות שהם נשארים פעילים.
- לבנות פיד על media_url בלבד. Meta משמיטה אותו בחלק מהסרטונים, לכן יש להשאיר את permalink או את thumbnail_url כחלופה.
- לבקש permalink בפריטי קרוסלה. Meta לא מחזירה אותו לתמונות שבתוך אלבום, לכן יש לקשר לפוסט האב.
- לראות עמוד קצר כעמוד אחרון. עמוד יכול להחזיר פחות פריטים ממה שהפרמטר limit מבקש; יש לעצור רק כשלא נשאר עוד סמן לעמוד הבא.
US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.
שאלות נפוצות
כמה פוסטים יכול ה-API של Instagram להחזיר?
עד 10,000 האחרונים שנוצרו, בעמוד בכל פעם מנקודת media. סטוריז מגיעים מנקודת הקצה stories הנפרדת, כל עוד הם פעילים.
האם נקודת media כוללת Reels?
כן. Reel הוא אובייקט IG Media כמו תמונה, ומדווח עם media_type מסוג VIDEO. סטוריז הם מה שנקודת media משמיטה.
אפשר לקבל את הפוסטים של חשבון אחר?
לא דרך נקודת media, שקוראת את החשבון שמאחורי האסימון. Business Discovery מחזירה פוסטים של חשבון עסקי או יוצר אחר, עם Facebook Login או עם Unified Login, שתיהן מאפשרות זאת.
למה כתובת media_url ישנה הפסיקה לעבוד?
כתובות ה-CDN של Meta מודעות לפרטיות: הן מפסיקות להחזיר מדיה אחרי שהתוכן נמחק או פג תוקפו, לכן מבקשים כתובות עדכניות כשצריך אותן.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-