Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

API Reels de Facebook : publier des Reels sur une Page

L'API Reels de Facebook publie un Reel sur une Page en trois étapes : POST /{page-id}/video_reels avec upload_phase start renvoie un video_id, la vidéo est envoyée sur rupload.facebook.com, puis POST /{page-id}/video_reels avec upload_phase finish et video_state PUBLISHED la publie. La spécification de Meta est une vidéo 9:16 de 3 à 90 secondes, et une Page peut publier 30 Reels via l'API en 24 heures.

easyCoexistence publie des vidéos sur une Page Facebook comme des publications vidéo classiques avec publish_facebook_post, depuis Claude, ChatGPT ou votre propre code, à côté du texte, des liens et des photos.

30 a day

Reels publiés via l'API par Page sur une période glissante de 24 heures, appliqué sur POST /{page_id}/video_reels.

3 to 90 s

Durée de Reel acceptée par Meta ; un Reel publié en story sur une Page ne peut pas dépasser 60 secondes.

540 x 960

Résolution minimale d'un Reel ; Meta recommande 1080 x 1920 pixels avec un format de 9 x 16.

29 days

Délai maximal que scheduled_publish_time peut fixer pour un Reel, d'au moins 10 minutes, avec video_state SCHEDULED.

1363128

Code d'erreur pour un Reel dont Facebook ne prend pas en charge la durée ; les Reels doivent durer de 3 à 90 secondes.

Comment l'API Reels publie-t-elle un Reel ?

En trois étapes sur deux hôtes. Les appels start et finish vont à l'edge video_reels de la Page sur graph.facebook.com, tandis que la vidéo elle-même est envoyée sur rupload.facebook.com, à l'upload_url renvoyée par l'appel start. Une vérification de statut sur l'ID de la vidéo, entre l'envoi et l'appel finish, indique si Meta a reçu le fichier entier et l'a traité.

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

Quelle vidéo faut-il pour un Reel ?

Meta publie ses spécifications des Reels dans le guide Reels Publishing, et un envoi qui ne respecte pas le format, la résolution, la durée ou la fréquence d'images est refusé avec un code d'erreur propre. Un Reel destiné à une story de Page doit aussi rester dans les 60 secondes.

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

Comment la vidéo est-elle envoyée ?

Par un POST vers l'upload_url sur rupload.facebook.com, avec le token de Page dans un en-tête Authorization : OAuth. Un fichier présent sur votre machine est envoyé comme corps de la requête, avec un en-tête offset à 0 et file_size égal à sa taille en octets. Un fichier déjà en ligne est envoyé à la place avec un en-tête file_url, et Meta le récupère ; un envoi réussi renvoie success à true.

  • file_url accepte les adresses http ou https ; les URL qui exigent une authentification ne sont pas prises en charge.
  • L'hôte doit laisser l'agent utilisateur facebookexternalhit/1.1 récupérer le fichier, car Meta rejette les fichiers provenant de sites qui le bloquent dans robots.txt.
  • Les fichiers hébergés sur le CDN de Meta, comme les URL fbcdn, sont rejetés ; Meta recommande le crossposting pour réutiliser une vidéo sur une autre Page.
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"

Comment vérifier le statut d'un Reel ?

Avec GET /{video-id}?fields=status sur graph.facebook.com. La réponse contient video_status, qui vaut uploading, upload_complete, processing, ready, upload_failed, expired ou error, et un objet par phase : uploading_phase avec bytes_transfered, processing_phase avec le message d'erreur éventuel, et publishing_phase avec publish_status (draft, scheduled, published ou error) et publish_time. Le statut de chaque phase est not_started, in_progress, completed ou error.

Comment reprendre un envoi interrompu ?

En renvoyant le POST d'envoi avec l'en-tête offset réglé sur uploading_phase.bytes_transfered issu d'une vérification de statut, soit les octets que Meta a déjà reçus. Un offset que Meta n'accepte pas renvoie OffsetInvalidError, un corps dont la longueur ne correspond pas à celle du fichier renvoie PartialRequestError, et si un nouvel envoi ne fonctionne pas, Meta conseille de recommencer depuis la première étape.

Que prend l'appel finish ?

Le video_id de l'appel start, upload_phase réglé sur finish et video_state réglé sur PUBLISHED, DRAFT ou SCHEDULED. description porte le texte et accepte les hashtags. title, place pour une Page de lieu et is_ai_generated, qui indique que le Reel a été créé ou modifié avec l'IA, sont facultatifs. Un Reel programmé ajoute scheduled_publish_time, un horodatage UNIX de plus de 10 minutes et d'au plus 29 jours dans le futur. Meta répond avec success à true.

Combien de Reels une Page peut-elle publier via l'API ?

30 sur une période glissante de 24 heures. Meta applique la limite sur POST /{page_id}/video_reels au moment de la publication et recommande aux applications de l'appliquer elles aussi, surtout celles qui permettent de programmer des publications. Les invitations de collaborateurs ont une limite propre, 10 par Page sur 24 heures, et la référence video_reels mentionne l'erreur 613 : les appels à cette API ont dépassé la limite de débit.

Quelles autorisations et quelle tâche sur la Page sont nécessaires ?

Un token de Page émis par une personne qui peut effectuer la tâche CREATE_CONTENT sur la Page, avec pages_show_list, pages_read_engagement et pages_manage_posts accordées via Facebook Login. Meta demande aussi aux applications d'afficher à la personne une mention sur l'usage de ses Reels sur Facebook, avec des options pour la contrôler, et de n'offrir que l'audience Public, car la publication sur une Page a une portée publique implicite.

Quelles erreurs l'API Reels renvoie-t-elle ?

Le code 100 signale un paramètre obligatoire manquant, comme upload_phase, et le message de Meta liste ceux qui manquent. Quatre autres codes refusent une vidéo qui sort des spécifications :

  • 1363040 : le ratio d'aspect n'est pas pris en charge ; les vidéos doivent être comprises entre 16x9 et 9x16.
  • 1363127 : la résolution n'est pas prise en charge ; le minimum est de 540 x 960 pixels.
  • 1363128 : la durée n'est pas prise en charge ; les Reels durent de 3 à 90 secondes.
  • 1363129 : la fréquence moyenne d'images n'est pas prise en charge ; les Reels doivent avoir de 24 à 60 images par seconde.

Comment lister les Reels d'une Page ?

Avec GET /{page-id}/video_reels, qui renvoie les Reels publiés de la Page avec leurs ID, dates de mise à jour et descriptions. since et until restreignent la liste à des dates données sous la forme today, yesterday, un horodatage UNIX ou yyyy-mm-dd, until devant être postérieur à since. La référence du feed de Meta renvoie à cet edge pour les Reels publiés sur une Page.

Comment publier un Reel avec easyCoexistence ?

Pas en tant que Reel, pour l'instant. publish_facebook_post envoie les vidéos vers l'edge videos de la Page, comme des publications vidéo classiques, et easyCoexistence n'a pas d'outil pour les appels video_reels ; les tokens de Page ne sont pas remis, les trois étapes ne peuvent donc pas non plus s'exécuter depuis votre propre code sur sa connexion. Publiez le Reel depuis Facebook ou Meta Business Suite, ou publiez la vidéo comme une publication vidéo classique.

Erreurs courantes

  • Envoyer l'upload vers graph.facebook.com. La vidéo va sur rupload.facebook.com avec un en-tête Authorization : OAuth ; seuls les appels start, finish et de statut utilisent graph.facebook.com.
  • Héberger le fichier là où Meta ne peut pas le récupérer. Un file_url derrière une authentification, sur un site dont robots.txt bloque facebookexternalhit/1.1, ou sur fbcdn, est rejeté.
  • Recommencer depuis le début après un envoi interrompu. Lisez d'abord le statut : uploading_phase.bytes_transfered est l'offset à reprendre, et une nouvelle session est le dernier recours.
  • Mettre en file plus de 30 Reels pour une même Page en une journée. Meta compte les Reels publiés via l'API sur une période glissante de 24 heures ; répartissez donc les programmations.
Faire cela avec EasyCoexistence

Il n'a pas d'outil pour l'API Reels, un Reel se publie donc depuis Facebook ou Meta Business Suite. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Peut-on publier un Reel sur un profil Facebook ou un groupe via l'API ?

Non. L'API de publication de Reels de Meta publie les Reels sur les Pages Facebook, et ne les crosspost que vers des Pages.

publish_facebook_post publie-t-il des Reels ?

Non. Il publie du texte, des liens, des photos et des vidéos sur la Page. Un Reel passe par les appels video_reels, que les outils d'easyCoexistence n'effectuent pas.

Comment vérifier un Reel pour les correspondances de droits d'auteur ?

Lisez GET /{video-id}?fields=copyright_check_information avec pages_read_engagement. Meta effectue la vérification à l'envoi, elle peut prendre quelques minutes, et seul le propriétaire voit les correspondances.

Une autre Page peut-elle aussi publier votre Reel ?

Oui, en tant que collaborateur. POST /{video-id}/collaborators avec target_id réglé sur l'ID de leur Page envoie une invitation ; une fois celle-ci acceptée, le Reel apparaît aussi sur leur Page.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le