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

Τα insights των Stories στο Instagram μέσω του API

Το endpoint των insights media του Instagram επιστρέφει για ένα Story, όσο είναι ενεργό, αυτές τις μετρήσεις: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts και total_interactions. Το navigation αναλύεται ανά story_navigation_action_type σε TAP_FORWARD, TAP_BACK, TAP_EXIT και SWIPE_FORWARD. Οι μετρήσεις Story είναι διαθέσιμες για 24 ώρες, οι τιμές κάτω από 5 επιστρέφουν σφάλμα 10, και το Instagram Login δεν έχει webhook story_insights.

Το easyCoexistence διαβάζει τα insights ενός Story με το get_social_insights όσο είναι ενεργό, ώστε το Claude, το ChatGPT ή ο δικός σας κώδικας να ρωτούν πώς πήγαν τα σημερινά Stories και να λαμβάνουν απευθείας από τη Meta, για τον συνδεδεμένο λογαριασμό, προσέγγιση, προβολές, απαντήσεις, κοινοποιήσεις και πλοήγηση.

24 hours

Για πόσο διάρκειας είναι διαθέσιμες μέσω του API οι μετρήσεις media των Stories.

Error 10

Επιστρέφεται αντί για τιμή όταν μια μέτρηση Story είναι κάτω από 5: δεν υπάρχουν αρκετοί θεατές ώστε το media να εμφανίσει insights.

Facebook Login

Η μόνη ρύθμιση που αναφέρει ο οδηγός insights της Meta για το webhook story_insights· δεν υποστηρίζεται με το Instagram Login.

0

Η τιμή των replies για Story που δημιουργήθηκε από λογαριασμό στην Ευρώπη ή στην Ιαπωνία.

22 Jun 2026

Όταν η Meta πρόσθεσε το link_clicks για Stories, μετρώντας τα πατήματα σε συνδέσμους, όπως τα link stickers, μόνο με Facebook Login.

Ποιες μετρήσεις επιστρέφει ένα Story;

Εκείνες που αναφέρει η Meta για media_product_type STORY, τις οποίες διαβάζετε με GET /<STORY_MEDIA_ID>/insights όσο το Story είναι ενεργό. Με Instagram Login η κλήση γίνεται στο graph.instagram.com με token που έχει τα instagram_business_basic και instagram_business_manage_insights, και το period είναι πάντα lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

Πώς διαβάζετε την πλοήγηση ανά ενέργεια;

Ζητήστε το navigation μόνο του με breakdown=story_navigation_action_type. Το σύνολο επιστρέφει στο total_value.value και κάθε ενέργεια στο total_value.breakdowns[].results, οι οποίες αθροίζονται σε αυτό: TAP_FORWARD (Forward), TAP_BACK (Back), TAP_EXIT (Exit) και SWIPE_FORWARD (Next Story). Το δείγμα απάντησης της Meta γράφει τις τιμές με πεζά γράμματα:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

Για πόσο διάρκειας είναι διαθέσιμες οι μετρήσεις Story;

24 ώρες. Η Meta καθιστά τις μετρήσεις media των Stories διαθέσιμες μόνο για 24 ώρες, δηλαδή για τη δική τους διάρκεια ζωής, ενώ τα δεδομένα πίσω από αυτές μπορεί να καθυστερούν έως 48 ώρες. Διαβάστε τις με χρονοπρογραμματισμό όσο το Story είναι ενεργό και κρατήστε τις τελευταίες τιμές που λάβατε. Η Meta σημειώνει ότι δεδομένα μπορεί να φτάνουν και μετά τη λήξη ενός Story, αν προστεθεί σε highlight, και ότι τότε οι κλήσεις του API, τα webhooks και η εφαρμογή μπορεί να δείχνουν διαφορετικά αποτελέσματα.

Γιατί μια μέτρηση Story επιστρέφει σφάλμα 10;

Επειδή η τιμή της είναι κάτω από 5. Η Meta επιστρέφει τον κωδικό σφάλματος 10 με το μήνυμα (#10) Not enough viewers for the media to show insights αντί για έναν μικρό αριθμό, οπότε ένα Story που το έχουν δει λίγοι μπορεί να αποτύχει, ενώ ένα πιο δημοφιλές πετυχαίνει. Αντιμετωπίστε το ως χαμηλή καταμέτρηση και όχι ως διακοπή λειτουργίας, και μην το επαναλαμβάνετε σε βρόχο.

Γιατί τα replies ενός Story είναι 0;

Λόγω περιφερειακών κανόνων. Οι απαντήσεις από άτομα στην Ευρώπη, από 1 Δεκεμβρίου 2020, και στην Ιαπωνία, από 14 Απριλίου 2021, δεν συμπεριλαμβάνονται στη μέτρηση replies, οπότε ένα Story που δημιούργησε λογαριασμός σε μία από αυτές τις περιοχές επιστρέφει 0. Η αναφορά της Meta ορίζει τα replies ως IG Comments στο αντικείμενο media του Story.

Υπάρχει webhook story_insights;

Όχι με Instagram Login. Ο πίνακας πεδίων της Meta σημειώνει το story_insights ως μη διαθέσιμο εκεί, η αναφορά insights media λέει ότι το webhook insights δεν υποστηρίζεται με Instagram Login, και ο οδηγός insights αναφέρει το story_insights μόνο για Facebook Login. Με Facebook Login το πεδίο ενεργοποιείται όταν λήγει ένα Story, περιέχει μόνο τις πρώτες 24 ώρες μετρήσεων και επιστρέφει τις καταμετρήσεις κάτω από 5 ως -1.

Ποιες μετρήσεις Story έχουν αποσυρθεί ή περιοριστεί;

Μερικά ονόματα εξακολουθούν να εμφανίζονται σε παλιό κώδικα ή στο changelog της Meta:

  • impressions: παρωχημένο για media που δημιουργήθηκαν μετά τις 2 Ιουλίου 2024, οπότε ένα τρέχον Story αναφέρει views.
  • taps_forward, taps_back και exits: αποσύρθηκαν στις 11 Δεκεμβρίου 2023· το navigation, αναλυμένο ανά story_navigation_action_type, αναφέρει τις ίδιες ενέργειες.
  • link_clicks: πατήματα σε συνδέσμους, όπως τα link stickers, προστέθηκε στις 22 Ιουνίου 2026 μόνο για Facebook Login.
  • total_views: προβολές σε όλες τις επιφάνειες, συμπεριλαμβανομένου του προωθημένου media, διατίθεται μόνο με Facebook Login.

Πώς διαβάζει το get_social_insights ένα Story;

Με το ID media του Story ως object_id, το οποίο επιστρέφει το publish_instagram_post ως media_id όταν δημοσιεύει το Story, και τις μετρήσεις ως λίστα. Ζητήστε το navigation σε ξεχωριστή κλήση με params και breakdown ίσο με story_navigation_action_type, επειδή ένα breakdown που δεν υποστηρίζει μία από τις ζητούμενες μετρήσεις αποτυγχάνει ολόκληρη την κλήση. Τα σφάλματα της Meta, συμπεριλαμβανομένου του σφάλματος 10, επιστρέφουν όπως τα έγραψε η Meta.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Συνηθισμένα λάθη

  • Η ανάγνωση των μετρήσεων Story την επομένη. Η Meta τις καθιστά διαθέσιμες μόνο για 24 ώρες, οπότε συλλέξτε τις όσο το Story είναι ενεργό.
  • Η επανάληψη του σφάλματος 10 σε βρόχο. Σημαίνει τιμή κάτω από 5, δηλαδή λίγους θεατές, και δεν αλλάζει έως ότου το δει περισσότερος κόσμος.
  • Το αίτημα navigation μαζί με breakdown δίπλα σε άλλες μετρήσεις. Το story_navigation_action_type λειτουργεί μόνο με το navigation, και ένα μη υποστηριζόμενο breakdown αποτυγχάνει ολόκληρη την κλήση.
  • Η αναμονή για story_insights με Instagram Login. Η Meta δεν προσφέρει εκεί αυτό το webhook, οπότε κάντε polling στο endpoint insights πριν λήξει το Story.
Κάντε το με EasyCoexistence

Τα Stories δημοσιεύονται με το publish_instagram_post. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Αλλάζουν τα insights ενός Story όταν προστεθεί σε highlight;

Μπορεί. Η Meta λέει ότι ένα Story που προστίθεται σε highlight μπορεί να συνεχίσει να λαμβάνει δεδομένα μετά τη λήξη του, οπότε το API, τα webhooks και η εφαρμογή μπορεί να διαφωνούν για ένα διάστημα.

Λειτουργεί το total_views για Stories με Instagram Login;

Όχι. Το total_views, που μετρά προβολές σε όλες τις επιφάνειες με συμπεριλαμβανόμενο το προωθημένο media, διατίθεται μόνο με Facebook Login· με Instagram Login ζητήστε views.

Μπορεί το API να διαβάσει τα πατήματα σε link sticker ενός Story στο Instagram;

Μόνο με Facebook Login. Η Meta πρόσθεσε το link_clicks για Stories στις 22 Ιουνίου 2026, μετρώντας τα πατήματα σε συνδέσμους όπως τα link stickers, και δεν το προσφέρει με Instagram Login.

Τι αντικατέστησε τα taps_forward, taps_back και exits;

Το navigation, αναλυμένο ανά story_navigation_action_type σε TAP_FORWARD, TAP_BACK, TAP_EXIT και SWIPE_FORWARD. Οι παλιές μετρήσεις αποσύρθηκαν στις 11 Δεκεμβρίου 2023.

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

Insights του Instagram μέσω του API: μετρικές λογαριασμού και postΤα μετρικά που επιστρέφει το API του Instagram για λογαριασμό και ανά post, Reel και Story, με τα όρια, τις καθυστερήσεις και τις μετονομασίες της Meta.Δημοσίευση ιστοριών στο Instagram μέσω του APIΠώς το API του Instagram δημοσιεύει ιστορίες: απαιτήσεις εικόνας και βίντεο, τι μπορεί να περιέχει μια ιστορία, οι 24 ώρες της και οι μετρικές της.Insights των Instagram Reels μέσω του APIΜετρικές Reels του API του Instagram: views, reach, likes, shares, saved, χρόνος και ποσοστό παράλειψης, καθώς και οι καταργημένες με τις αντικαταστάσεις τους.Δημογραφικά ακολούθων στο Instagram μέσω του APIΠώς το API του Instagram επιστρέφει τα follower_demographics και engaged_audience_demographics: ηλικία, φύλο, πόλη, χώρα, χρονικά διαστήματα και όρια.Αναφορές και απαντήσεις σε Story του Instagram στο webhookΠώς φτάνουν οι αναφορές και απαντήσεις σε Story στο πεδίο messages του webhook: story_mention, reply_to.story, το CDN URL και το παράθυρο απάντησης.Πεδία webhook του Instagram: η πλήρης λίσταΤα πεδία webhook της Meta για το Instagram API με Instagram Login: τι ενεργοποιεί το καθένα, τι δικαίωμα χρειάζεται και ποια ανήκουν στο Facebook Login.

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

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

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

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