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

תובנות Instagram דרך ה-API: מדדי חשבון ופוסטים

ה-API של Instagram מחזיר תובנות לחשבון מקצועי ולכל אחד מהפוסטים, ה-Reels והסטוריז שלו. מדדי החשבון כוללים הגעה, צפיות, חשבונות שהתקיימה איתם אינטראקציה, עוקבים חדשים והסרות מעקב, לייקים, תגובות, שמירות ושיתופים. מדדי הפוסט כוללים הגעה, צפיות, לייקים, תגובות, שמירות ושיתופים. Meta מציינת שהנתונים עשויים להתעכב עד 48 שעות.

easyCoexistence קורא תובנות Instagram עם get_social_insights, כך שאפשר לשאול את Claude או את ChatGPT איך הפוסטים של השבוע האחרון עבדו, ולקבל הגעה, צפיות, לייקים, תגובות, שמירות ושיתופים ישירות מ-Meta, לחשבון או לפוסט בודד.

48 hours

כמה זמן הנתונים שמאחורי מדדי Instagram עשויים להתעכב.

100 followers

מתחת לסף הזה לא מוחזרים לחשבון עוקבים חדשים והסרות מעקב, וגם לא נתוני דמוגרפיה של עוקבים.

2 years

כמה זמן Meta שומרת מדדי מדיה.

24 hours

כמה זמן מדדי סטורי נשארים זמינים דרך ה-API.

21 Apr 2025

מתי impressions הפסיק לעבוד בכל גרסות ה-API, למעט במדיה שנוצרה לפני 2 ביולי 2024; views החליפו אותו.

אילו מדדי חשבון זמינים?

קוראים עם GET /<IG_ID>/insights, בעיקר עם period=day ועם metric_type=total_value:

  • reach: מספר החשבונות הייחודיים שראו את התוכן, כולל מודעות; הערך מוערך.
  • views: מספר הפעמים שהתוכן הופעל או הוצג.
  • accounts_engaged: חשבונות שהתקיימה איתם אינטראקציה עם התוכן, כולל מודעות; הערך מוערך.
  • follows_and_unfollows: עוקבים חדשים והסרות מעקב בתקופה; נדרשים לפחות 100 עוקבים.
  • likes, comments, saves, shares, replies, reposts וגם total_interactions.
  • profile_links_taps: הקשות על כפתורי הכתובת העסקית, שיחה, אימייל והודעה.
  • follower_demographics וכן engaged_audience_demographics: גיל, עיר, מדינה ומגדר.

אילו מדדי פוסט זמינים?

קוראים עם GET /<IG_MEDIA_ID>/insights; אילו מדדים רלוונטיים תלוי בפורמט. בפוסט או ב-Reel, לייקים, תגובות, צפיות וסך האינטראקציות סופרים רק פעילות אורגנית, ולא מעורבות במודעות שנוצרו ממנו.

  • פוסטים וכן Reels: reach, views, likes, comments, saved, shares, total_interactions וגם reposts.
  • ב-Reels בלבד: ig_reels_avg_watch_time, ig_reels_video_view_total_time וכן reels_skip_rate.
  • פוסטים וסטוריז: follows, profile_visits וכן profile_activity.
  • סטוריז: reach, views, shares, replies, navigation, reposts וגם total_interactions.

איך פועלים period, metric_type והפילוחים?

למדדי חשבון נשלח period=day. metric_type=total_value מחזיר ערך אחד לטווח, וזה מה שהפילוחים צריכים; time_series מחזיר ערך לכל יום וזמין ל-reach. פילוחים מפצלים סך לפי media_product_type (פוסטים, קרוסלות, Reels, סטוריז ומודעות), לפי follow_type (עוקבים או לא) או לפי contact_button_type.

מדדי דמוגרפיה לוקחים timeframe כמו this_week או this_month במקום since וגם until, ואם לא שולחים since וגם until, שאר המדדים מסתכלים 24 שעות אחורה. בקשה לפילוח שאחד המדדים המבוקשים לא תומך בו נכשלת כולה עם שגיאה לא ידועה.

אילו סף ועיכובים חלים?

הכללים של Meta לגבי המועד שבו מספר מופיע וכמה זמן הוא נשאר זמין:

  • הנתונים עשויים להתעכב עד 48 שעות.
  • לחשבונות עם פחות מ-100 עוקבים אין follows_and_unfollows או follower_demographics; עבור engaged_audience_demographics נדרשות 100 מעורבויות בטווח הזמן.
  • נתון חסר או לא זמין מוחזר כקבוצה ריקה, ולא כ-0.
  • מדדי דמוגרפיה מחזירים רק 45 הערכים המובילים.
  • מדדי חשבון נשמרים עד 90 יום, ומדדי מדיה עד שנתיים.

מה שונה בסטוריז ובקרוסלות?

מדדי סטורי זמינים 24 שעות בלבד, וערך מתחת ל-5 מחזיר קוד שגיאה 10, "not enough viewers", במקום מספר. תגובות מאנשים באירופה וביפן לא נספרות, וסטורי שנוצר בחשבון שנמצא שם מדווח 0 תגובות. עם Instagram Login אין וובהוק (Webhook) של story_insights, לכן מספרי הסטורי צריך לקרוא בזמן שהסטורי פעיל.

קרוסלה מדווחת כפוסט אחד: Meta לא מחזירה תובנות לתמונות ולסרטונים שבתוכה.

למה שמות המדדים משתנים?

כי Meta מפסיקה ומשנה שמות של מדדים בין גרסות ה-API. impressions הוגדר כמיושן ב-v22.0 והפסיק לעבוד בכל הגרסות ב-21 באפריל 2025, למעט במדיה שנוצרה לפני 2 ביולי 2024; במקומו הוצג views. באותו זמן הפסיקו plays, clips_replays_count וגם ig_reels_aggregated_all_plays_count. video_views וכמה סדרות זמן של פרופיל, ביניהן profile_views, הוסרו קודם לכן. בקשה עם שם שהופסק נכשלת, לכן רשימת מדדים שנכתבה לגרסה מוקדמת יותר של ה-API עלולה לדרוש עדכון.

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

  • בקשת impressions. זה כבר לא עובד בשום גרסת API; בקשו במקום views.
  • לראות תוצאה ריקה כאפס. Meta מחזירה קבוצת נתונים ריקה כשמדד אינו זמין, וזה לא זהה לחוסר פעילות.
  • קריאת מדדי סטורי אחרי שהסטורי מסתיים. הם זמינים רק 24 שעות.
  • הוספת פילוח לבקשה למספר מדדים. אם אחד מהם לא תומך בו, הקריאה כולה נכשלת.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

מה החליף את impressions ב-API של Instagram?

views, שסופר את הפעמים שהתוכן הופעל או הוצג. Meta הפסיקה את impressions בכל גרסות ה-API ב-21 באפריל 2025, למעט במדיה שנוצרה לפני 2 ביולי 2024.

למה החשבון שלי לא מחזיר נתוני עוקבים?

Meta לא מחזירה follows_and_unfollows או דמוגרפיה של עוקבים לחשבונות עם פחות מ-100 עוקבים.

כמה אחורה אפשר לקרוא תובנות Instagram?

עד 90 יום של מדדי חשבון ועד שנתיים של מדדי מדיה, כאשר online_followers מכסה רק את 30 הימים האחרונים.

האם המספרים כוללים מודעות?

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

המשיכו לקרוא

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

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

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

נבדק ב-