Δημογραφικά ακολούθων στο Instagram μέσω του API
Το endpoint των insights λογαριασμού του Instagram επιστρέφει δημογραφικά στοιχεία ακολούθων με metric=follower_demographics, period=lifetime, metric_type=total_value, ένα timeframe και ένα breakdown ανά ηλικία, φύλο, πόλη ή χώρα. Το 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 σε κάθε έκδοση.
Πόση καθυστέρηση μπορεί να έχουν τα δεδομένα πίσω από τις μετρικές του λογαριασμού.
Ποιες δημογραφικές μετρικές υπάρχουν;
Δύο στην αναφορά insights της Meta, και τα δύο διαβάζονται με GET /<IG_ID>/insights, και δύο παλαιότερα σύνολα που ο παλιός κώδικας ακόμα ζητά:
follower_demographics: τα δημογραφικά χαρακτηριστικά των ακολούθων του λογαριασμού.engaged_audience_demographics: τα ίδια για το κοινό που αλληλεπιδρά, δηλαδή τους λογαριασμούς που αλληλεπίδρασαν με το περιεχόμενό του.- Και τα δύο: period lifetime,
metric_typetotal_value, ένα timeframe και ένα breakdown ανά ηλικία, πόλη, χώρα ή φύλο. audience_gender_age,audience_locale,audience_countryκαιaudience_city: αποσύρθηκαν στις 11 Δεκεμβρίου 2023.reached_audience_demographics: αναφέρεται στο changelog της Meta του 2024, αλλά λείπει από τον τρέχοντα πίνακα μετρικών της.
Πώς ζητάτε τα δημογραφικά των ακολούθων;
Με τη μετρική, period=lifetime, metric_type=total_value, ένα timeframe και ένα breakdown. Το timeframe αντικαθιστά τα since και until, τα οποία οι δημογραφικές μετρικές δεν υποστηρίζουν, και είναι υποχρεωτικό. Με Instagram Login το token χρειάζεται τις άδειες 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 και το breakdown που ζητήθηκε, και κάθε αποτέλεσμα συνδυάζει dimension_values, το χρονικό διάστημα και μία τιμή του breakdown, με ένα πλήθος. Το δείγμα της 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. Η καταχώριση του changelog δεν αναφέρει το follower_demographics.
Ποια όρια και περιορισμοί ισχύουν;
Η αναφορά insights του λογαριασμού της Meta ορίζει αυτούς τους κανόνες για τις δημογραφικές μετρικές:
- Το
follower_demographicsδεν επιστρέφεται για λογαριασμό με λιγότερους από 100 ακολούθους. - Το
engaged_audience_demographicsδεν επιστρέφεται με λιγότερες από 100 αλληλεπιδράσεις μέσα στο χρονικό διάστημα. - Επιστρέφονται μόνο οι 45 κορυφαίες τιμές, οπότε οι μικρότερες πόλεις και χώρες εξαιρούνται.
- Μετράνε μόνο οι θεατές με δημογραφικά δεδομένα, άρα οι τιμές μπορεί να αθροίζουν λιγότερο από το πλήθος των ακολούθων.
- Τα ελλιπή δεδομένα επιστρέφουν κενό σύνολο, όχι 0, και τα δεδομένα μπορεί να καθυστερούν έως 48 ώρες.
- Ένα breakdown που δεν υποστηρίζει η ζητούμενη μετρική αποτυγχάνει ολόκληρη την κλήση με το μήνυμα «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 ως host. Ο λογαριασμός πρέπει να είναι επιχειρηματικός ή creator λογαριασμός, όπως απαιτεί η Instagram Platform της Meta.
Πώς το get_social_insights διαβάζει τα δημογραφικά;
Με το metrics ορισμένο σε follower_demographics ή engaged_audience_demographics, το period ορισμένο σε lifetime και το params να περιέχει timeframe, breakdown και metric_type. Το easyCoexistence καλεί GET /<IG_ID>/insights για τον συνδεδεμένο λογαριασμό με το token του και επιστρέφει την απάντηση της 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.
- Αθροίζετε ένα breakdown για να βρείτε το πλήθος των ακολούθων. Μετράνε μόνο οι θεατές με δημογραφικά δεδομένα και επιστρέφονται μόνο οι 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 στο API του Instagram;
Το follower_demographics, με ένα breakdown ανά ηλικία, φύλο, πόλη ή χώρα. Η 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
Επαληθεύτηκε στις