ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

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 όταν ένα όνομα μετρικής έχει καταργηθεί.

3 seconds

Το χρονικό παράθυρο που μετρά το reels_skip_rate: το ποσοστό των views όπου το Reel παραλείφθηκε μέσα στα πρώτα 3 δευτερόλεπτα.

21 Apr 2025

Πότε καταργήθηκαν τα plays, clips_replays_count και ig_reels_aggregated_all_plays_count σε κάθε έκδοση του API.

3 Dec 2025

Πότε προστέθηκαν τα reels_skip_rate, reposts, crossposted_views και facebook_views στα media insights.

48 hours

Πόσο μπορεί να καθυστερεί η διαθεσιμότητα των δεδομένων πίσω από τις μετρικές μέσων.

2 years

Για πόσο χρονικό διάστημα αποθηκεύει η Meta τις μετρικές μέσων.

Ποιες μετρικές επιστρέφει ένα Reel;

Αυτές που αναφέρει η σελίδα της Meta για τα media insights με media_product_type REELS, με ανάγνωση μέσω GET /<IG_MEDIA_ID>/insights και παράμετρο μετρικών διαχωρισμένη με κόμμα. Η Meta χαρακτηρίζει αρκετές από αυτές ως εκτιμώμενες ή σε ανάπτυξη, όπως σημειώνεται δίπλα σε καθεμία, και μετρά τα likes και τα comments μόνο ως οργανική δραστηριότητα:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Τι επιστρέφει ένα αίτημα insights για Reels;

Ένα αντικείμενο ανά μετρική μέσα στο data, με name, period, values, title, description και id. Το period είναι πάντα lifetime: το ορίζει η Meta για τις μετρικές μέσων και δεν αλλάζει, οπότε το αίτημα δεν το χρειάζεται. Η σελίδα της Meta περιγράφει τις δύο μετρικές χρόνου παρακολούθησης ως χρονικές διάρκειες χωρίς να ονομάζει μονάδα, γι' αυτό ελέγξτε τις με ένα Reel που γνωρίζετε πριν τις σχεδιάσετε σε γράφημα.

A Reels insights request and the shape of its answer
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 χρειάζεται ενημέρωση:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

Τι μετράνε τα 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 του λογαριασμού.

get_social_insights arguments for one Reel
{
  "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 επιστρέφει κενό σύνολο δεδομένων όταν τα δεδομένα δεν υπάρχουν ή είναι προσωρινά μη διαθέσιμα.
Κάντε το με EasyCoexistence

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.

Συνεχίστε την ανάγνωση

Insights του Instagram μέσω του API: μετρικές λογαριασμού και postΤα μετρικά που επιστρέφει το API του Instagram για λογαριασμό και ανά post, Reel και Story, με τα όρια, τις καθυστερήσεις και τις μετονομασίες της Meta.Instagram API: καταργημένες μετρικές, τα impressions και τα plays αντικαθίστανται από τα viewsΟι μετρικές insights του Instagram που η Meta κατήργησε το 2025, όπως impressions, plays και video_views, με ημερομηνίες και τι να αλλάξετε στον κώδικα.Δημοσίευση Instagram Reels μέσω του APIΠώς το API του Instagram δημοσιεύει Reels: οι απαιτήσεις βίντεο της Meta, τα containers, ο χρόνος επεξεργασίας, η κοινοποίηση στο Feed και οι μετρήσεις.Τα insights των Stories στο Instagram μέσω του APIΟι μετρήσεις Story που επιστρέφει το API του Instagram, από προσέγγιση, προβολές και απαντήσεις έως πλοήγηση, διάρκεια και σφάλμα 10.Δημογραφικά ακολούθων στο Instagram μέσω του APIΠώς το API του Instagram επιστρέφει τα follower_demographics και engaged_audience_demographics: ηλικία, φύλο, πόλη, χώρα, χρονικά διαστήματα και όρια.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις