נתוני דמוגרפיה של עוקבים ב-Instagram דרך ה-API
נקודת הקצה ל-insights של Instagram מחזירה דמוגרפיה של עוקבים עם metric=follower_demographics, period=lifetime, metric_type=total_value, טווח זמן ופילוח לפי גיל, מגדר, עיר או מדינה. engaged_audience_demographics עושה את אותו הדבר עבור חשבונות שהתקשרו עם התוכן. Meta מחזירה רק את 45 הערכים המובילים. נתוני עוקבים דורשים 100 עוקבים, ונתוני מעורבות דורשים 100 מעורבויות בטווח הזמן.
EasyCoexistence קוראת דמוגרפיה של עוקבים וקהל מעורב ב-Instagram דרך get_social_insights, כך ש-Claude, ChatGPT או הקוד שלכם יוכלו לשאול אילו מדינות, ערים או קבוצות גיל עוקבות אחרי החשבון ולקבל את המספרים של Meta עבור החשבון המחובר.
מתחת לסף הזה, follower_demographics לא מוחזר עבור החשבון.
נדרשות מעורבויות בטווח הזמן כדי ש-engaged_audience_demographics יוחזר.
מדדי הדמוגרפיה מחזירים רק את 45 הערכים המובילים, כך שערים ומדינות קטנות לא יופיעו.
מתי last_14_days, last_30_days, last_90_days ו-prev_month הפסיקו לעבוד עבור engaged_audience_demographics בכל הגרסאות.
הזמן המרבי שבו נתוני המדדים של החשבון עלולים להתעכב.
אילו מדדי דמוגרפיה קיימים?
שניים בחומר העזר של Meta על insights של חשבון, ששניהם נקראים עם GET /<IG_ID>/insights, ושתי קבוצות ישנות שקוד ישן עדיין מבקש:
follower_demographics: מאפייני הדמוגרפיה של עוקבי החשבון.engaged_audience_demographics: אותם מאפיינים עבור הקהל המעורב, החשבונות שהתקשרו עם התוכן.- שניהם: period ל-lifetime,
metric_typeל-total_value, timeframe, ופילוח לפי גיל, עיר, מדינה או מגדר. audience_gender_age,audience_locale,audience_countryו-audience_city: הוצאו משימוש ב-11 בדצמבר 2023.reached_audience_demographics: מופיע ביומן השינויים של Meta מ-2024, אך נעדר מטבלת המדדים הנוכחית שלה.
איך מבקשים דמוגרפיה של עוקבים?
עם metric, period=lifetime, metric_type=total_value, timeframe ופילוח אחד. timeframe מחליף את since ו-until, שמדדי הדמוגרפיה אינם תומכים בהם, והוא חובה. עם Instagram Login האסימון צריך את instagram_business_basic ואת instagram_business_manage_insights, והקריאה הולכת אל graph.instagram.com:
GET https://graph.instagram.com/<IG_ID>/insights
?metric=follower_demographics
&period=lifetime
&timeframe=this_month
&breakdown=country
&metric_type=total_value
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>איך נראית התגובה?
הספירות נמצאות בשדה total_value.breakdowns. השדה dimension_keys מציין את timeframe ואת הפילוח שנדרש, וכל תוצאה מזווגת בין dimension_values, טווח הזמן וערך אחד של הפילוח, לצד ספירה. לדוגמה מהתיעוד של Meta עבור הקהל המעורב לפי מדינה, המדינות מוחזרות כקודים בני שתי אותיות כמו US ו-ES:
{
"data": [
{
"name": "follower_demographics",
"period": "lifetime",
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"total_value": {
"breakdowns": [
{
"dimension_keys": ["timeframe", "country"],
"results": [
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> },
{ "dimension_values": ["<TIMEFRAME>", "<COUNTRY_CODE>"], "value": <COUNT> }
]
}
]
},
"id": "<IG_ID>/insights/follower_demographics/lifetime"
}
]
}אילו טווחי זמן עובדים?
התיעוד של Meta מפרט את last_14_days, last_30_days, last_90_days, prev_month, this_month ו-this_week לשני המדדים. לקהל המעורב הוא מתאר את this_month כ-30 הימים האחרונים ואת this_week כ-7 הימים האחרונים. עבור engaged_audience_demographics ארבעת הראשונים הפסיקו לעבוד מ-v20.0 ובכל הגרסאות מ-19 באוגוסט 2024, לכן משתמשים ב-this_week או ב-this_month. רשומת יומן השינויים הזה אינה מציינת את follower_demographics.
אילו ספים וגבולות חלים?
חומר העזר של Meta על insights של החשבון קובע את הכללים הבאים למדדי הדמוגרפיה:
follower_demographicsלא מוחזר לחשבון עם פחות מ-100 עוקבים.engaged_audience_demographicsלא מוחזר עם פחות מ-100 מעורבויות בטווח הזמן.- מוחזרים רק 45 הערכים המובילים, כך שערים ומדינות קטנות לא יופיעו.
- נספרים רק צופים עם נתוני דמוגרפיה, ולכן הערכים יכולים להסתכם בפחות ממספר העוקבים.
- נתונים חסרים מחזירים קבוצה ריקה, לא 0, והנתונים יכולים לפגר עד 48 שעות.
- כשמבקשים פילוח שהמדד אינו תומך בו, הקריאה כולה נכשלת, והודעת השגיאה היא "An unknown error has occurred" (שגיאה לא ידועה).
האם דמוגרפיה עובדת עם Instagram Login?
כן. Meta פתחה insights של חשבון ושל מדיה לאפליקציות של Instagram Login ב-21 בינואר 2025. חומר העזר שלה על insights של חשבון מציין את Instagram Login עם ההרשאות instagram_business_basic ו-instagram_business_manage_insights, ואת graph.instagram.com כשרת היעד. החשבון חייב להיות חשבון עסקי או חשבון יוצר, כפי שנדרש על ידי Instagram Platform של Meta.
איך get_social_insights קורא דמוגרפיה?
כשהשדה metrics הוא follower_demographics או engaged_audience_demographics, השדה period הוא lifetime, והשדה params כולל את timeframe, את breakdown ואת metric_type. EasyCoexistence שולחת בקשת GET אל /<IG_ID>/insights עבור החשבון המחובר, עם האסימון שלו, ומחזירה את התשובה של Meta, כך ש-Claude או ChatGPT יוכלו לומר אילו מדינות, ערים או קבוצות גיל עוקבות אחרי החשבון.
{
"account_id": "<ACCOUNT_ID>",
"metrics": ["follower_demographics"],
"period": "lifetime",
"params": {
"timeframe": "this_month",
"breakdown": "age",
"metric_type": "total_value"
}
}טעויות נפוצות
- שליחת since ו-until. מדדי הדמוגרפיה אינם תומכים בהם: timeframe קובע את הטווח, והוא חובה.
- שימוש ב-last_30_days או ב-last_90_days עבור הקהל המעורב. טווחים אלה הפסיקו לעבוד עבור engaged_audience_demographics בכל הגרסאות ב-19 באוגוסט 2024.
- סיכום הפילוח כדי לקבל את מספר העוקבים. נספרים רק צופים עם נתוני דמוגרפיה, ומוחזרים רק 45 הערכים המובילים, ולכן הסכום נמוך ממספר העוקבים.
- ציפייה לנתונים מחשבון קטן. דמוגרפיה של עוקבים דורשת 100 עוקבים, והקהל המעורב דורש 100 מעורבויות בטווח הזמן.
US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
כמה עוקבים צריך חשבון Instagram כדי לקבל דמוגרפיה?
100. מתחת לזה Meta לא מחזירה follower_demographics, ו-engaged_audience_demographics דורש 100 מעורבויות בטווח הזמן.
למה Instagram מחזיר רק 45 ערים?
מדדי הדמוגרפיה של Meta מחזירים רק את 45 הערכים המובילים, ולכן ערים ומדינות קטנות יותר לא נכללות.
מה החליף את audience_gender_age ב-Instagram API?
follower_demographics, עם פילוח לפי גיל, מגדר, עיר או מדינה. Meta הוציאה משימוש את audience_gender_age, audience_locale, audience_country ו-audience_city ב-11 בדצמבר 2023.
אפשר להשתמש ב-since וב-until עם follower_demographics?
לא. מדדי הדמוגרפיה אינם תומכים ב-since וב-until. הפרמטר timeframe קובע את הטווח במקומם, והוא חובה.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-