Δημοσίευση ιστοριών στο Instagram μέσω του API
Το API του Instagram δημοσιεύει μία ιστορία από μία εικόνα ή ένα βίντεο σε δημόσιο URL: δημιουργείτε ένα container με media_type STORIES και έπειτα το δημοσιεύετε. Οι εικόνες είναι JPEG έως 8 MB, τα βίντεο διαρκούν από 3 έως 60 δευτερόλεπτα και έχουν μέγεθος έως 100 MB, η Meta συνιστά κάδρο 9:16, και η ιστορία εξαφανίζεται μετά από 24 ώρες, όπως και στην εφαρμογή.
Το easyCoexistence δημοσιεύει ιστορίες εικόνας και βίντεο με το publish_instagram_post από το Claude, το ChatGPT ή τον δικό σας κώδικα, και μπορεί να τις προγραμματίσει από τη δική του ουρά.
Η μέγιστη διάρκεια βίντεο ιστορίας που δημοσιεύει το API: το μικρότερο είναι 3 δευτερόλεπτα και το αρχείο μπορεί να φτάσει τα 100 MB.
Το μέγιστο μέγεθος εικόνας ιστορίας, που πρέπει να είναι JPEG.
Πόσο διάστημα παραμένει ανοιχτή μια δημοσιευμένη ιστορία πριν λήξει.
Μετρικές ιστορίας τόσο χαμηλές επιστρέφονται ως σφάλμα 10, ανεπαρκείς θεατές, αντί για αριθμό.
Πώς δημοσιεύεται μια ιστορία;
Με τις ίδιες δύο κλήσεις όπως κάθε ανάρτηση. POST /<IG_ID>/media με media_type ορισμένο σε STORIES και είτε image_url είτε video_url, και έπειτα POST /<IG_ID>/media_publish με το ID του container. Ένα βίντεο ιστορίας επεξεργάζεται πρώτα, οπότε το status_code του container πρέπει να γράφει FINISHED πριν μπορεί να δημοσιευτεί.
Η αναφορά της Meta περιγράφει τη λεζάντα για φωτογραφίες, βίντεο και carousels, όχι για ιστορίες, οπότε ό,τι προορίζεται για τον θεατή πρέπει να μπει στην ίδια την εικόνα ή το βίντεο.
Ποιες είναι οι απαιτήσεις πολυμέσων για ιστορίες;
Η Meta συνιστά κάδρο 9:16 τόσο για εικόνες όσο και για βίντεο ιστοριών, ώστε να αποφεύγεται το κόψιμο ή ο κενός χώρος.
- Εικόνα: JPEG, έως 8 MB, σε sRGB. Άλλοι χρωματικοί χώροι μετατρέπονται.
- Βίντεο: MOV ή MP4 με βίντεο H.264 ή HEVC και ήχο AAC, 23 έως 60 καρέ ανά δευτερόλεπτο, έως 1920 pixels πλάτος και 25 Mbps.
- Διάρκεια βίντεο: 3 έως 60 δευτερόλεπτα, με αρχείο έως 100 MB.
- Αναλογία βίντεο: γίνεται δεκτό οτιδήποτε από 0,1:1 έως 10:1.
Τι μπορεί να περιέχει μια ιστορία;
Την ίδια την εικόνα ή το βίντεο, και αναφορές σε άλλους λογαριασμούς: από τον Ιούλιο του 2025 η παράμετρος user_tags επισημαίνει δημόσιους λογαριασμούς σε ιστορίες εικόνας και βίντεο, με προαιρετικές συντεταγμένες x και y. Η Meta δεν υποστηρίζει τη δημοσίευση αυτοκόλλητων μέσω του API, οπότε οι σύνδεσμοι, οι δημοσκοπήσεις και οι τοποθεσίες παραμένουν στην εφαρμογή.
Τι συμβαίνει μετά τη δημοσίευση μιας ιστορίας;
Παραμένει για 24 ώρες και μετά λήγει, όπως στην εφαρμογή. Η Meta εμφανίζει τις ζωντανές ιστορίες σε ξεχωριστό stories edge· η λίστα πολυμέσων του λογαριασμού, GET /<IG_ID>/media, δεν τις περιλαμβάνει. Κατά την ανάγνωση, το media_type μιας ιστορίας είναι IMAGE ή VIDEO, όπως κάθε άλλο πολυμέσο, γι' αυτό οι ιστορίες ξεχωρίζουν από το πού τις βρήκατε και όχι από τον τύπο τους.
Πώς έρχονται οι απαντήσεις και οι αναφορές;
Ως άμεσα μηνύματα. Μια απάντηση σε ιστορία φτάνει στον λογαριασμό ως DM στο webhook messages, με το ID και το URL της ιστορίας επισυναπτόμενα, και ανοίγει το συνηθισμένο παράθυρο 24 ωρών για απάντηση. Όταν κάποιος αναφέρει τον λογαριασμό στη δική του ιστορία, αυτό έρχεται επίσης ως μήνυμα, με συνημμένο τύπου story_mention. Το Mentions API της Meta δεν καλύπτει ιστορίες.
Ποιες μετρικές αναφέρει μια ιστορία;
Προσέγγιση (reach), προβολές, κοινοποιήσεις, απαντήσεις, ακολουθήσεις, επισκέψεις προφίλ, δραστηριότητα προφίλ, πλοήγηση, κλικ σε συνδέσμους, επαναδημοσιεύσεις και συνολικές αλληλεπιδράσεις, που διαβάζονται μέσω του endpoint των insights πολυμέσων. Είναι διαθέσιμες μόνο για 24 ώρες, και μια τιμή κάτω από 5 επιστρέφει σφάλμα 10, ανεπαρκείς θεατές, αντί για αριθμό. Οι απαντήσεις από άτομα που βρίσκονται στην Ευρώπη ή την Ιαπωνία δεν υπολογίζονται, και μια ιστορία που δημιουργείται από λογαριασμό εκεί αναφέρει 0 απαντήσεις.
Συνηθισμένα λάθη
- Σχεδιάζετε αυτοκόλλητο συνδέσμου. Το API δεν δημοσιεύει αυτοκόλλητα, οπότε ένας σύνδεσμος πρέπει να φτάσει στους ανθρώπους με άλλον τρόπο, για παράδειγμα με μια απάντηση DM.
- Διαβάζετε τις μετρικές ιστορίας την επόμενη μέρα. Είναι διαθέσιμες μόνο για 24 ώρες, οπότε συλλέξτε τις όσο η ιστορία είναι ενεργή.
- Ψάχνετε μια δημοσιευμένη ιστορία στη λίστα πολυμέσων του λογαριασμού. Οι ζωντανές ιστορίες εμφανίζονται σε ξεχωριστό stories edge.
- Δημοσιεύετε βίντεο οριζόντιου κάδρου ως ιστορία. Η Meta συνιστά 9:16, και άλλα σχήματα μπορεί να δείξουν κενό χώρο ή να κοπούν.
Οι απαντήσεις σε μια ιστορία έρχονται ως DM, που μπορούν να προωθηθούν στο δικό σας endpoint ή να λάβουν απάντηση από αυτοματισμό. US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και δωρεάν δοκιμή τις πρώτες 3 ημέρες.
Συχνές ερωτήσεις
Μπορώ να προσθέσω αυτοκόλλητο συνδέσμου σε μια ιστορία μέσω του API;
Όχι. Η Meta δεν υποστηρίζει τη δημοσίευση αυτοκόλλητων μέσω του API, συμπεριλαμβανομένων των συνδέσμων, των δημοσκοπήσεων και των τοποθεσιών. Η αναφορά άλλου λογαριασμού χωρίς αυτοκόλλητο υποστηρίζεται.
Πού εμφανίζεται μια δημοσιευμένη ιστορία στο API;
Στο ξεχωριστό stories edge του λογαριασμού, όσο είναι ζωντανή. Το GET /<IG_ID>/media δεν περιλαμβάνει ιστορίες, και μια ιστορία διαβάζεται ως IMAGE ή VIDEO.
Μπορεί μια ιστορία να έχει λεζάντα μέσω του API;
Όχι. Η αναφορά της Meta δεν περιγράφει λεζάντα για ιστορίες, και το publish_instagram_post στέλνει μια ιστορία χωρίς αυτή, οπότε ό,τι προορίζεται για τον θεατή μπαίνει στην ίδια την εικόνα ή το βίντεο.
Για πόσο διάστημα είναι διαθέσιμα τα insights ιστοριών;
Για 24 ώρες. Η Meta καθιστά τις μετρικές ιστοριών διαθέσιμες μόνο για αυτό το διάστημα, οπότε διαβάστε τις όσο η ιστορία είναι ενεργή.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις