Insights των Instagram Reels μέσω του API
Το endpoint των media insights του Instagram, GET /<IG_MEDIA_ID>/insights, επιστρέφει για ένα Reel τις εξής μετρικές: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time και reels_skip_rate, καθώς και crossposted_views και facebook_views για ένα crossposted Reel. Οι μετρικές plays, clips_replays_count και ig_reels_aggregated_all_plays_count καταργήθηκαν τον Απρίλιο του 2025 και αντικαταστάθηκαν από το views.
Το easyCoexistence διαβάζει τα insights ενός Reel με το get_social_insights, ώστε να μπορεί το Claude, το ChatGPT ή ο δικός σας κώδικας να ρωτά πώς πήγε ένα Reel και να παίρνει views, reach, χρόνο παρακολούθησης και ποσοστό παράλειψης απευθείας από τη Meta για τον συνδεδεμένο λογαριασμό, με το σφάλμα της Meta όταν ένα όνομα μετρικής έχει καταργηθεί.
Το χρονικό παράθυρο που μετρά το reels_skip_rate: το ποσοστό των views όπου το Reel παραλείφθηκε μέσα στα πρώτα 3 δευτερόλεπτα.
Πότε καταργήθηκαν τα plays, clips_replays_count και ig_reels_aggregated_all_plays_count σε κάθε έκδοση του API.
Πότε προστέθηκαν τα reels_skip_rate, reposts, crossposted_views και facebook_views στα media insights.
Πόσο μπορεί να καθυστερεί η διαθεσιμότητα των δεδομένων πίσω από τις μετρικές μέσων.
Για πόσο χρονικό διάστημα αποθηκεύει η Meta τις μετρικές μέσων.
Ποιες μετρικές επιστρέφει ένα Reel;
Αυτές που αναφέρει η σελίδα της Meta για τα media insights με media_product_type REELS, με ανάγνωση μέσω GET /<IG_MEDIA_ID>/insights και παράμετρο μετρικών διαχωρισμένη με κόμμα. Η Meta χαρακτηρίζει αρκετές από αυτές ως εκτιμώμενες ή σε ανάπτυξη, όπως σημειώνεται δίπλα σε καθεμία, και μετρά τα likes και τα comments μόνο ως οργανική δραστηριότητα:
Τι επιστρέφει ένα αίτημα insights για Reels;
Ένα αντικείμενο ανά μετρική μέσα στο data, με name, period, values, title, description και id. Το period είναι πάντα lifetime: το ορίζει η Meta για τις μετρικές μέσων και δεν αλλάζει, οπότε το αίτημα δεν το χρειάζεται. Η σελίδα της Meta περιγράφει τις δύο μετρικές χρόνου παρακολούθησης ως χρονικές διάρκειες χωρίς να ονομάζει μονάδα, γι' αυτό ελέγξτε τις με ένα Reel που γνωρίζετε πριν τις σχεδιάσετε σε γράφημα.
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "views",
"period": "lifetime",
"values": [{ "value": <VALUE> }],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"id": "<IG_MEDIA_ID>/insights/views/lifetime"
}
]
}Ποιες μετρικές Reels καταργήθηκαν και τι τις αντικατέστησε;
Η Meta κατάργησε τις πρώτες τρεις από την Graph API v22.0 στις 21 Ιανουαρίου 2025, την ημέρα που εισήγαγε τα views, και σε κάθε έκδοση στις 21 Απριλίου 2025· το video_views καταργήθηκε από την v21.0 και σε κάθε έκδοση από τις 8 Ιανουαρίου 2025. Ένα αίτημα που ονομάζει καταργημένη μετρική αποτυγχάνει, οπότε μια λίστα μετρικών γραμμένη πριν από το 2025 χρειάζεται ενημέρωση:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
Τι μετράνε τα views και το reach σε ένα Reel;
Τα views είναι ο αριθμός των φορών που παίχτηκε το Reel στο Instagram, μετρική που η Meta χαρακτηρίζει σε ανάπτυξη· το reach είναι ο αριθμός των μοναδικών λογαριασμών που το είδαν τουλάχιστον μία φορά, το οποίο η Meta χαρακτηρίζει εκτιμώμενο. Τα likes, τα comments, τα views και τα total_interactions μετράνε μόνο την οργανική δραστηριότητα, εξαιρώντας τις αλληλεπιδράσεις σε διαφημίσεις που δημιουργήθηκαν από το Reel. Τα total_likes, total_comments και total_views, που περιλαμβάνουν προωθημένο περιεχόμενο, προσφέρονται μόνο με Facebook Login.
Ποια όρια και καθυστερήσεις ισχύουν;
Η σελίδα της Meta για τα media insights ορίζει αυτούς τους κανόνες για τους αριθμούς ενός Reel:
- Τα δεδομένα πίσω από τις μετρικές μπορεί να καθυστερήσουν έως 48 ώρες.
- Οι μετρικές μέσων αποθηκεύονται έως 2 χρόνια.
- Τα ελλιπή ή μη διαθέσιμα δεδομένα επιστρέφουν κενό σύνολο δεδομένων, όχι 0.
- Τα
crossposted_viewsκαιfacebook_viewsδίνουν σφάλμα για ένα Reel που δεν έγινε crossposted, γι' αυτό ζητήστε τα σε δική τους κλήση. - Μια ανάλυση που δεν υποστηρίζεται από μια ζητούμενη μετρική αποτυγχάνει ολόκληρο το αίτημα, με το σφάλμα An unknown error has occurred.
- Με Instagram Login το token χρειάζεται τα
instagram_business_basicκαιinstagram_business_manage_insights, στο graph.instagram.com.
Πώς διαβάζει το get_social_insights ένα Reel;
Με το account_id της σύνδεσης, το media ID του Reel ως object_id και μια λίστα μετρικών. Το easyCoexistence καλεί GET /<IG_MEDIA_ID>/insights στο graph.instagram.com με το token του λογαριασμού, περνά τα ονόματα των μετρικών στη Meta όπως δίνονται και επιστρέφει τα δεδομένα της Meta, ή το δικό της σφάλμα όταν ένα όνομα έχει καταργηθεί. Το list_social_posts επιστρέφει τα media IDs των πρόσφατων αναρτήσεων και Reels του λογαριασμού.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<REEL_MEDIA_ID>",
"metrics": [
"views", "reach", "likes", "comments", "shares", "saved",
"total_interactions", "ig_reels_avg_watch_time",
"ig_reels_video_view_total_time", "reels_skip_rate"
]
}Συνηθισμένα λάθη
- Αίτημα για plays ή clips_replays_count. Και τα δύο καταργήθηκαν σε κάθε έκδοση του API στις 21 Απριλίου 2025· ζητήστε το views.
- Ανάμειξη των crossposted_views ή facebook_views σε ένα γενικό αίτημα. Δίνουν σφάλμα για ένα Reel που δεν έγινε crossposted, και το σφάλμα αποτυγχάνει την κλήση.
- Υπόθεση μονάδας για τον χρόνο παρακολούθησης. Η Meta δεν ονομάζει μονάδα για τα ig_reels_avg_watch_time ή ig_reels_video_view_total_time, οπότε ελέγξτε με ένα γνωστό Reel.
- Ανάγνωση κενού αποτελέσματος ως μηδέν. Η Meta επιστρέφει κενό σύνολο δεδομένων όταν τα δεδομένα δεν υπάρχουν ή είναι προσωρινά μη διαθέσιμα.
US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με δωρεάν δοκιμή 3 ημερών.
Συχνές ερωτήσεις
Γιατί ένα αίτημα insights για Reels επιστρέφει κενό αποτέλεσμα;
Η Meta επιστρέφει κενό σύνολο δεδομένων, όχι 0, όταν τα δεδομένα δεν υπάρχουν ή είναι προσωρινά μη διαθέσιμα, και τα δεδομένα πίσω από τις μετρικές μπορεί να καθυστερήσουν έως 48 ώρες.
Πώς παίρνω τον χρόνο παρακολούθησης των Reels από το API;
Ζητήστε το ig_reels_avg_watch_time για τον μέσο όρο και το ig_reels_video_view_total_time για το σύνολο, συμπεριλαμβανομένων των επαναπροβολών, από το GET /<IG_MEDIA_ID>/insights.
Τι είναι το reels_skip_rate;
Το ποσοστό των αρχικών views όπου το Reel παραλείφθηκε μέσα στα πρώτα 3 δευτερόλεπτα. Η Meta το πρόσθεσε στις 3 Δεκεμβρίου 2025 και το χαρακτηρίζει εκτιμώμενο και σε ανάπτυξη.
Τα insights των Reels περιλαμβάνουν προβολές διαφημίσεων;
Όχι. Τα likes, τα comments, τα views και τα total_interactions μετράνε μόνο την οργανική δραστηριότητα· το total_views, που περιλαμβάνει προωθημένο περιεχόμενο, προσφέρεται μόνο με Facebook Login.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις