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

Facebook Reels API: δημοσίευση Reels σε Σελίδα

Το Facebook Reels API δημοσιεύει ένα Reel σε μια Σελίδα σε τρία βήματα: POST /{page-id}/video_reels με upload_phase start επιστρέφει ένα video_id, το βίντεο στέλνεται στο rupload.facebook.com, και POST /{page-id}/video_reels με upload_phase finish και video_state PUBLISHED το δημοσιεύει. Η προδιαγραφή της Meta είναι βίντεο 9:16 διάρκειας 3 έως 90 δευτερολέπτων, και μια Σελίδα μπορεί να δημοσιεύσει 30 Reels μέσω του API σε 24 ώρες.

Το easyCoexistence δημοσιεύει βίντεο σε μια Σελίδα Facebook ως κανονικές αναρτήσεις βίντεο με το publish_facebook_post, από το Claude, το ChatGPT ή τον δικό σας κώδικα, δίπλα σε κείμενο, συνδέσμους και φωτογραφίες.

30 a day

Reels που δημοσιεύονται μέσω API ανά Σελίδα, μέσα σε κυλιόμενη περίοδο 24 ωρών, με έλεγχο στο POST /{page_id}/video_reels.

3 to 90 s

Διάρκεια Reel που δέχεται η Meta. Ένα Reel που δημοσιεύεται ως story σε Σελίδα δεν μπορεί να υπερβαίνει τα 60 δευτερόλεπτα.

540 x 960

Ελάχιστη ανάλυση Reel. Η Meta προτείνει 1080 x 1920 pixels σε λόγο διαστάσεων 9 x 16.

29 days

Το μακρύτερο scheduled_publish_time που μπορεί να ορίσει ένα Reel, τουλάχιστον 10 λεπτά μπροστά, με video_state SCHEDULED.

1363128

Κωδικός σφάλματος για Reel του οποίου τη διάρκεια το Facebook δεν υποστηρίζει. Τα Reels πρέπει να διαρκούν 3 έως 90 δευτερόλεπτα.

Πώς δημοσιεύει το Reels API ένα Reel;

Σε τρία βήματα σε δύο hosts. Οι κλήσεις start και finish πηγαίνουν στο edge video_reels της Σελίδας στο graph.facebook.com, ενώ το ίδιο το βίντεο πηγαίνει στο rupload.facebook.com, στο upload_url που επιστρέφει η κλήση start. Ένας έλεγχος κατάστασης στο ID του βίντεο ανάμεσα στο upload και στο finish δείχνει αν η Meta έχει λάβει ολόκληρο το αρχείο και το έχει επεξεργαστεί.

1StartPOST /{page-id}/video_reels, upload_phase start: returns video_id and upload_url
2UploadPOST to rupload.facebook.com with the bytes or a file_url header
3CheckGET /{video-id}?fields=status until processing completes
4FinishPOST /{page-id}/video_reels, upload_phase finish, video_state PUBLISHED

Τι βίντεο χρειάζεται ένα Reel;

Η Meta δημοσιεύει τις προδιαγραφές των Reels στον οδηγό Reels Publishing, και ένα upload που δεν πληροί τον λόγο διαστάσεων, την ανάλυση, τη διάρκεια ή τον ρυθμό καρέ απορρίπτεται με δικό του κωδικό σφάλματος. Ένα Reel που προορίζεται για story Σελίδας πρέπει επίσης να μένει εντός των 60 δευτερολέπτων.

File.mp4 recommended
Aspect ratio9 x 16
Resolution1080 x 1920 recommended, 540 x 960 at least
Frame rate24 to 60 fps, fixed, progressive scan
Duration3 to 90 seconds
VideoH.264 or H.265 (VP9 and AV1 also supported), 4:2:0, closed GOP of 2 to 5 s
AudioAAC Low Complexity, 48 kHz, stereo, 128 kbps or more

Πώς ανεβαίνει το βίντεο;

Με POST στο upload_url στο rupload.facebook.com, με το token της Σελίδας στην κεφαλίδα Authorization: OAuth. Ένα αρχείο στον υπολογιστή σας στέλνεται ως σώμα του αιτήματος, με κεφαλίδα offset ίση με 0 και file_size ίσο με το μέγεθός του σε bytes. Ένα αρχείο που είναι ήδη online στέλνεται με κεφαλίδα file_url, και η Meta το ανακτά μόνη της. Ένα επιτυχές upload επιστρέφει success ίσο με true.

  • Το file_url δέχεται διευθύνσεις http ή https. Δεν υποστηρίζονται URL που απαιτούν ταυτοποίηση.
  • Ο host πρέπει να επιτρέπει στον user agent facebookexternalhit/1.1 να ανακτήσει το αρχείο, αφού η Meta απορρίπτει αρχεία σε ιστότοπους που το μπλοκάρουν στο robots.txt.
  • Αρχεία στο δικό του CDN της Meta, όπως τα URL fbcdn, απορρίπτονται. Η Meta προτείνει το crossposting για να επαναχρησιμοποιηθεί ένα βίντεο σε άλλη Σελίδα.
Uploading a hosted video
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
  -H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
  -H "file_url: https://example.com/reel.mp4"

Πώς ελέγχετε την κατάσταση ενός Reel;

Με GET /{video-id}?fields=status στο graph.facebook.com. Η απάντηση περιέχει το video_status, που παίρνει την τιμή uploading, upload_complete, processing, ready, upload_failed, expired ή error, και ένα αντικείμενο για κάθε φάση: uploading_phase με bytes_transfered, processing_phase με τυχόν μήνυμα σφάλματος και publishing_phase με publish_status (draft, scheduled, published ή error) και publish_time. Η κατάσταση κάθε φάσης είναι not_started, in_progress, completed ή error.

Πώς συνεχίζεται ένα διακοπτόμενο upload;

Με νέο POST του upload, με την κεφαλίδα offset ίση με uploading_phase.bytes_transfered από έναν έλεγχο κατάστασης, δηλαδή τα bytes που έχει ήδη η Meta. Ένα offset που η Meta δεν δέχεται επιστρέφει OffsetInvalidError, ένα σώμα που δεν ταιριάζει με το μήκος του αρχείου επιστρέφει PartialRequestError, και όταν το νέο upload δεν δουλεύει, η Meta συνιστά να ξεκινήσετε από το πρώτο βήμα.

Τι παίρνει η κλήση finish;

Το video_id από την κλήση start, upload_phase ίσο με finish και video_state ίσο με PUBLISHED, DRAFT ή SCHEDULED. Το description φέρει το κείμενο και υποστηρίζει hashtags. Τα title, place για Σελίδα τοποθεσίας και is_ai_generated, που δηλώνει ότι το Reel δημιουργήθηκε ή επεξεργάστηκε με AI, είναι προαιρετικά. Ένα προγραμματισμένο Reel προσθέτει scheduled_publish_time, ένα UNIX timestamp που είναι πάνω από 10 λεπτά και έως 29 ημέρες μπροστά. Η Meta απαντά με success ίσο με true.

Πόσα Reels μπορεί να δημοσιεύσει μια Σελίδα μέσω του API;

30 μέσα σε κυλιόμενη περίοδο 24 ωρών. Η Meta εφαρμόζει το όριο στο POST /{page_id}/video_reels όταν δημοσιεύεται ένα Reel, και συνιστά στις εφαρμογές να το εφαρμόζουν και οι ίδιες, ειδικά αυτές που επιτρέπουν στους χρήστες να προγραμματίζουν αναρτήσεις. Οι προσκλήσεις συνεργατών έχουν δικό τους όριο, 10 ανά Σελίδα ανά 24 ώρες, και η αναφορά του video_reels περιλαμβάνει το σφάλμα 613: οι κλήσεις σε αυτό το API ξεπέρασαν το όριο ρυθμού.

Ποια δικαιώματα και ποια εργασία Σελίδας χρειάζεται;

Ένα token πρόσβασης Σελίδας από κάποιον που μπορεί να εκτελέσει την εργασία CREATE_CONTENT στη Σελίδα, με τα pages_show_list, pages_read_engagement και pages_manage_posts χορηγημένα μέσω του Facebook Login. Η Meta ζητά επίσης από τις εφαρμογές να δείχνουν στο άτομο μια γνωστοποίηση για το πώς χρησιμοποιούνται τα Reels του στο Facebook, με επιλογές ελέγχου, και να προσφέρουν μόνο το κοινό Public, αφού η δημοσίευση σε Σελίδα έχει σιωπηρά δημόσια εμβέλεια.

Ποια σφάλματα επιστρέφει το Reels API;

Ο κωδικός 100 σημαίνει ότι λείπει μια απαιτούμενη παράμετρος, όπως το upload_phase, και το μήνυμα της Meta τις απαριθμεί. Τέσσερις ακόμη κωδικοί απορρίπτουν βίντεο εκτός προδιαγραφών:

  • 1363040: ο λόγος διαστάσεων δεν υποστηρίζεται. Τα βίντεο πρέπει να είναι μεταξύ 16x9 και 9x16.
  • 1363127: η ανάλυση δεν υποστηρίζεται. Το ελάχιστο είναι 540 x 960 pixels.
  • 1363128: η διάρκεια δεν υποστηρίζεται. Τα Reels διαρκούν 3 έως 90 δευτερόλεπτα.
  • 1363129: ο μέσος ρυθμός καρέ δεν υποστηρίζεται. Τα Reels χρειάζονται 24 έως 60 καρέ ανά δευτερόλεπτο.

Πώς καταγράφονται τα Reels μιας Σελίδας;

Με GET /{page-id}/video_reels, που επιστρέφει τα δημοσιευμένα Reels της Σελίδας με τα ID τους, τις ημερομηνίες ενημέρωσης και τις περιγραφές τους. Οι since και until περιορίζουν τη λίστα σε ημερομηνίες που δίνονται ως today, yesterday, UNIX timestamp ή yyyy-mm-dd, με το until μεταγενέστερο του since. Η αναφορά του feed της Meta δείχνει σε αυτό το edge για τα Reels που δημοσιεύονται σε Σελίδα.

Πώς δημοσιεύετε ένα Reel μέσω του easyCoexistence;

Όχι ως Reel, προς το παρόν. Το publish_facebook_post στέλνει βίντεο στο edge videos της Σελίδας, ως κανονικές αναρτήσεις βίντεο, και το easyCoexistence δεν έχει εργαλείο για τις κλήσεις video_reels· τα tokens των Σελίδων δεν παραδίδονται, γι' αυτό τα τρία βήματα δεν μπορούν να τρέξουν ούτε από τον δικό σας κώδικα στη σύνδεσή του. Δημοσιεύστε το Reel από το Facebook ή το Meta Business Suite, ή αναρτήστε το βίντεο ως κανονική ανάρτηση βίντεο.

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

  • Αποστολή του upload στο graph.facebook.com. Το βίντεο πηγαίνει στο rupload.facebook.com με κεφαλίδα Authorization: OAuth. Μόνο οι κλήσεις start, finish και ελέγχου κατάστασης χρησιμοποιούν το graph.facebook.com.
  • Φιλοξενία του αρχείου εκεί όπου η Meta δεν μπορεί να το ανακτήσει. Ένα file_url πίσω από σύνδεση, σε ιστότοπο του οποίου το robots.txt μπλοκάρει το facebookexternalhit/1.1, ή στο fbcdn απορρίπτεται.
  • Επανεκκίνηση από την αρχή μετά από διακοπή του upload. Διαβάστε πρώτα την κατάσταση: το uploading_phase.bytes_transfered είναι το offset από το οποίο συνεχίζεται το upload, και μια νέα συνεδρία είναι η τελευταία λύση.
  • Υπέρβαση του ορίου των 30 Reels για μία Σελίδα μέσα σε μία ημέρα. Η Meta μετρά τα Reels που δημοσιεύονται μέσω API σε κυλιόμενη περίοδο 24 ωρών, οπότε διανείμετε τα προγραμματισμένα.
Κάντε το με EasyCoexistence

Δεν έχει εργαλείο για το Reels API, γι' αυτό ένα Reel δημοσιεύεται από το Facebook ή το Meta Business Suite. US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, με τις πρώτες 3 ημέρες δωρεάν.

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

Μπορεί ένα Reel να δημοσιευτεί μέσω του API σε προφίλ ή ομάδα στο Facebook;

Όχι. Το Reels Publishing API της Meta δημοσιεύει Reels σε Σελίδες του Facebook, και τα κάνει crosspost μόνο σε Σελίδες.

Το publish_facebook_post δημοσιεύει Reels;

Όχι. Δημοσιεύει κείμενο, συνδέσμους, φωτογραφίες και βίντεο στη Σελίδα. Ένα Reel θέλει τις κλήσεις video_reels, τις οποίες τα εργαλεία του easyCoexistence δεν κάνουν.

Πώς ελέγχω ένα Reel για αντιστοιχίες πνευματικής ιδιοκτησίας;

Διαβάστε το GET /{video-id}?fields=copyright_check_information με το pages_read_engagement. Η Meta εκτελεί τον έλεγχο κατά το upload, μπορεί να διαρκέσει μερικά λεπτά, και μόνο ο ιδιοκτήτης βλέπει τις αντιστοιχίες.

Μπορεί και άλλη Σελίδα να δημοσιεύσει το Reel μου;

Ναι, ως συνεργάτης. Το POST /{video-id}/collaborators με target_id ίσο με το ID της Σελίδας του την στέλνει ως πρόσκληση, και μόλις την αποδεχτεί, το Reel εμφανίζεται και στη δική της Σελίδα.

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

Ανάρτηση βίντεο σε Facebook Page μέσω του APIΠώς να ανεβάσετε βίντεο σε Facebook Page μέσω του Graph API: file_url ή αρχείο στο /videos, τίτλος, περιγραφή και κατάσταση επεξεργασίας.Facebook Page Stories μέσω του APIΤο Stories API της Meta δημοσιεύει Stories φωτογραφίας και βίντεο σε Facebook Page: photo_stories, video_stories, κανόνες μέσων και λίστα.Reels και μετρήσεις βίντεο μέσω του API του FacebookΟι μετρήσεις βίντεο και Reels του Facebook για το 2026, πώς τις διαβάζετε από το video_insights και ποιες μετρήσεις εμφανίσεων και θεατών κατήργησε η Meta.Το API των αναρτήσεων Facebook Page: κείμενο, σύνδεσμοι, φωτογραφίες και βίντεοΔημοσίευση αναρτήσεων Facebook Page μέσω του Graph API: κείμενο και σύνδεσμοι στο /feed, φωτογραφίες στο /photos, βίντεο στο /videos.Δικαιώματα API σελίδων Facebook και απαιτήσεις App ReviewΤα εννέα δικαιώματα σελίδων Facebook, τι ανοίγει το καθένα και τι ζητά η Meta στο App Review: Advanced Access, επαλήθευση επιχείρησης, εγγραφή οθόνης.Όρια ρυθμού του Facebook Graph API: σφάλματα 4, 17, 32, 613 και 80001Σφάλματα 4, 17, 32, 613 και 80001 του Facebook API: τι σημαίνουν τα όρια ρυθμού και πότε να ξαναδοκιμάσετε.

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

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

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

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