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

ספירת עוקבים ושדות פרופיל של Instagram דרך ה-API

ה-API של Instagram מחזיר את מספר העוקבים של חשבון מקצועי בשדה followers_count, לצד follows_count, media_count, username, name, profile_picture_url וכן account_type. עם Instagram Login, קריאת GET /me עם השדות האלה מחזירה אותם מהכתובת graph.instagram.com, בהרשאה instagram_business_basic. מסמך העזר של Meta ל-IG User מפרט גם את biography ואת website, ושינויים במספר העוקבים לאורך זמן מגיעים מ-insights.

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

followers_count

מספר המשתמשים הכולל ב-Instagram שעוקבים אחר החשבון, שדה שמסמך העזר של IG User מסמן כציבורי.

9 fields

השדות לאובייקט User שמדריך Instagram Login של Meta מפרט, כולל id, user_id, followers_count וגם media_count.

Media_Creator

הערך של account_type עבור חשבון יוצר; חשבון עסקי מחזיר Business.

100 followers

מתחת לסף הזה, Meta אינה מחזירה לחשבון את follows_and_unfollows ולא את follower_count.

אילו שדות פרופיל מחזיר Instagram Login?

תשעת השדות שמדריך Instagram Login של Meta מפרט לאובייקט User, נקראים עם GET /me ורשימת fields. הטוקן צריך את instagram_business_basic, והערך של user_id, לא של id, הוא IG_ID של החשבון לקריאות שבאות אחר כך:

idThe app user's app-scoped ID
user_idThe professional account's ID, the id in its webhook notifications
usernameThe account's username
nameThe profile name
account_typeBusiness or Media_Creator
profile_picture_urlThe profile picture's URL
followers_countAccounts following it
follows_countAccounts it follows
media_countMedia published on the account

איך קוראים את מספר העוקבים?

מבקשים את followers_count בנתיב /me. מסמך העזר של Meta מציין שזה צומת User של החשבון שמאחורי הטוקן. הערך הוא סכום מצטבר ברגע הקריאה, ולכן לוח בקרה שמציג גרף צריך לשמור קריאה כל יום בעצמו.

Counts and username with Instagram Login
GET https://graph.instagram.com/me
  ?fields=user_id,username,followers_count,follows_count,media_count
  &access_token=<ACCESS_TOKEN>

{
  "user_id": "<IG_ID>",
  "username": "<USERNAME>",
  "followers_count": 1840,
  "follows_count": 312,
  "media_count": 97
}

אילו שדות נוספים מופיעים במסמך העזר של Meta?

מסמך העזר של Meta ל-IG User, שנכתב לשלושת ההגדרות יחד, מוסיף שדות מעבר לתשעת השדות של מדריך Instagram Login. הוא מסמן כמה מהם כזמינים לחשבונות המקושרים לעמוד, ושאר השדות לא מקבלים הערה על כניסה:

  • biography: הטקסט של הביו בפרופיל, מסומן כציבורי.
  • website: כתובת ה-URL של האתר בחשבון, מסומנת כציבורית.
  • has_profile_pic: האם לחשבון יש תמונת פרופיל.
  • is_published וגם legacy_instagram_user_id: בחשבונות המקושרים לעמוד, השדה השני הוא המזהה שנוצר עבור נקודות הקצה של Marketing API עד v21.0.
  • shopping_product_tag_eligibility: האם החשבון הגדיר Instagram Shop.

איך עוקבים אחר צמיחה בעוקבים?

דרך תובנות החשבון ולא דרך הפרופיל. GET /<IG_ID>/insights עם metric=follows_and_unfollows, metric_type=total_value ופילוח לפי follow_type מחזיר את החשבונות שעקבו, ואת אלה שביטלו מעקב או עזבו את Instagram. תחת Instagram Login הטוקן צריך גם את instagram_business_manage_insights. Meta מחזירה את הנתון הזה, וגם את follower_count, רק לחשבונות עם 100 עוקבים לפחות.

האם ה-API יכול להציג מי העוקבים?

לא. מסמך העזר של Meta ל-IG User נותן את followers_count ואת follows_count כמספרים, ולא מציין קשר שמחזיר את החשבונות שמאחוריהם. מה שכן מוצע הוא follower_demographics בתובנות החשבון, מפורט לפי גיל, עיר, מדינה או מגדר, לחשבונות עם 100 עוקבים לפחות.

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

בעזרת Business Discovery, ש-Meta מציעה עם Facebook Login ו-Unified Login: GET /<IG_ID>?fields=business_discovery.username(<USERNAME>){followers_count,media_count} מחזיר אותם לעסק או לחשבון יוצר אחר. הוא קורא את השדות הציבוריים של החשבון האחר, כפי שמסמך העזר של IG User מסמן אותם: biography, followers_count, id, media_count, username וגם website, בין היתר.

איך קוראים את הפרופיל דרך easyCoexistence?

list_social_accounts מחזיר לכל חשבון מחובר את username, name וגם external_id, שהוא IG_ID של החשבון. לספירות בפרופיל, followers_count, follows_count ו-media_count, אין כלי, ואסימונים של Instagram אינם נמסרים; get_social_insights קורא במקום זאת איך הקהל נע, עם follows_and_unfollows, reach ו-views.

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

  • לצפות לרשימת עוקבים. Meta מחזירה ספירות, ומ-100 עוקבים גם דמוגרפיה, אבל לא את החשבונות עצמם.
  • לשרטט צמיחה לפי followers_count בלבד. זהו סכום מצטבר; follows_and_unfollows בתובנות מפריד בין עוקבים חדשים לביטולי מעקב.
  • לבדוק את account_type מול הערך CREATOR. חשבון יוצר מחזיר Media_Creator, וחשבון עסקי מחזיר Business.
  • לקחת את id מתוך /me כמזהה החשבון. מדריך Meta קושר את user_id, לא את id, להודעות וובהוק (Webhook) ולנתיבים כמו /<IG_ID>/media.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

האם ה-API של Instagram מחזיר את הביו של הפרופיל?

כן, בתור biography, שאותו Meta מסמנת כציבורי במסמך העזר של IG User. תשעת שדות ה-User במדריך Instagram Login משמיטים אותו, ולכן בקשו אותו ב-GET /me ובדקו את התגובה בהגדרה שלכם.

למה follows_and_unfollows לא מחזיר כלום?

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

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

לא. ה-API של Meta משרת חשבונות מקצועיים, ו-Business Discovery קורא רק חשבונות עסקיים ויוצרים.

איזו הרשאה נדרשת למספר העוקבים?

עם Instagram Login, instagram_business_basic. תובנות עוקבים מוסיפות את instagram_business_manage_insights.

המשיכו לקרוא

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

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

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

נבדק ב-