AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Facebook Reels API: Reels auf einer Seite veröffentlichen

Die Facebook Reels API veröffentlicht ein Reel in drei Schritten auf einer Seite: POST /{page-id}/video_reels mit upload_phase start liefert eine video_id, das Video wird an rupload.facebook.com gesendet, und POST /{page-id}/video_reels mit upload_phase finish und video_state PUBLISHED veröffentlicht es. Metas Vorgabe lautet ein Hochformatvideo im Format 9:16 mit 3 bis 90 Sekunden Länge, und eine Seite kann über die API innerhalb von 24 Stunden 30 Reels veröffentlichen.

easyCoexistence veröffentlicht Videos auf einer Facebook-Seite mit publish_facebook_post als reguläre Videobeiträge, aus Claude, ChatGPT oder Ihrem eigenen Code, neben Text, Links und Fotos.

30 a day

API-veröffentlichte Reels pro Seite innerhalb eines gleitenden 24-Stunden-Zeitraums, durchgesetzt bei POST /{page_id}/video_reels.

3 to 90 s

Reel-Dauer, die Meta akzeptiert; ein als Story auf einer Seite veröffentlichtes Reel darf 60 Sekunden nicht überschreiten.

540 x 960

Mindestauflösung des Reels; Meta empfiehlt 1080 x 1920 Pixel bei einem Seitenverhältnis von 9 x 16.

29 days

Maximaler Vorlauf, den scheduled_publish_time bei einem Reel setzen kann, mindestens 10 Minuten im Voraus, mit video_state SCHEDULED.

1363128

Fehlercode für ein Reel, dessen Dauer Facebook nicht unterstützt; Reels müssen 3 bis 90 Sekunden lang sein.

Wie veröffentlicht die Reels API ein Reel?

In drei Schritten über zwei Hosts. Start- und Abschlussaufruf gehen an den Edge video_reels der Seite auf graph.facebook.com, das Video selbst an rupload.facebook.com, und zwar an die upload_url, die der Startaufruf zurückgibt. Eine Statusprüfung der Video-ID zwischen Upload und Abschluss zeigt, ob Meta die gesamte Datei hat und sie verarbeitet hat.

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

Welches Video braucht ein Reel?

Meta veröffentlicht die Reels-Spezifikationen im Leitfaden Reels Publishing. Ein Upload, der bei Seitenverhältnis, Auflösung, Dauer oder Bildrate abweicht, wird mit einem eigenen Fehlercode abgelehnt. Ein Reel, das als Story einer Seite gedacht ist, muss außerdem innerhalb von 60 Sekunden bleiben.

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

Wie wird das Video hochgeladen?

Mit einem POST an die upload_url auf rupload.facebook.com, wobei das Seiten-Token im Header Authorization: OAuth steckt. Eine Datei auf dem eigenen Rechner wird als Inhalt der Anfrage gesendet, mit dem Header offset auf 0 und file_size auf die Größe in Bytes. Eine Datei, die bereits online liegt, wird stattdessen über den Header file_url übergeben; Meta ruft sie ab. Ein erfolgreicher Upload liefert success mit dem Wert true.

  • file_url akzeptiert http- oder https-Adressen; URLs, die eine Authentifizierung verlangen, werden nicht unterstützt.
  • Der Host muss dem User-Agent facebookexternalhit/1.1 erlauben, die Datei abzurufen, da Meta Dateien auf Seiten ablehnt, die dies in robots.txt blockieren.
  • Dateien auf dem eigenen CDN von Meta, etwa fbcdn-URLs, werden abgelehnt; Meta verweist für die Wiederverwendung eines Videos auf einer anderen Seite auf 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"

Wie prüft man den Status eines Reels?

Mit GET /{video-id}?fields=status auf graph.facebook.com. Die Antwort enthält video_status, das uploading, upload_complete, processing, ready, upload_failed, expired oder error lautet, sowie je ein Objekt pro Phase: uploading_phase mit bytes_transfered, processing_phase mit einer etwaigen Fehlermeldung und publishing_phase mit publish_status (draft, scheduled, published oder error) und publish_time. Der Status jeder Phase selbst ist not_started, in_progress, completed oder error.

Wie wird ein unterbrochener Upload fortgesetzt?

Indem der Upload-POST erneut gesendet wird, wobei der Header offset auf uploading_phase.bytes_transfered aus einer Statusprüfung gesetzt ist, also die Bytes, die Meta bereits hat. Ein offset, den Meta nicht akzeptiert, liefert OffsetInvalidError, ein Inhalt, dessen Länge nicht zur Datei passt, liefert PartialRequestError, und wenn ein erneuter Upload nicht funktioniert, rät Meta, beim ersten Schritt neu zu beginnen.

Was verlangt der Abschlussaufruf?

Die video_id aus dem Startaufruf, upload_phase auf finish und video_state auf PUBLISHED, DRAFT oder SCHEDULED. description trägt den Text und unterstützt Hashtags. title, place für eine Seite mit Standort und is_ai_generated, das offenlegt, dass das Reel mit KI erstellt oder bearbeitet wurde, sind optional. Ein geplantes Reel ergänzt scheduled_publish_time, einen UNIX-Zeitstempel, der mehr als 10 Minuten und höchstens 29 Tage in der Zukunft liegt. Meta antwortet mit success auf true.

Wie viele Reels kann eine Seite über die API veröffentlichen?

30 innerhalb eines gleitenden 24-Stunden-Zeitraums. Meta erzwingt das Limit bei POST /{page_id}/video_reels, wenn ein Reel veröffentlicht wird, und empfiehlt Apps, es ebenfalls selbst durchzusetzen, besonders Apps, mit denen Nutzer Beiträge für später planen können. Einladungen zu Kollaboratoren haben ein eigenes Limit von 10 pro Seite in 24 Stunden, und die Referenz zu video_reels nennt Fehler 613: Aufrufe dieser API haben das Ratenlimit überschritten.

Welche Berechtigungen und Seitenaufgabe braucht sie?

Ein Seiten-Token von jemandem, der die Aufgabe CREATE_CONTENT auf der Seite ausführen darf, mit pages_show_list, pages_read_engagement und pages_manage_posts, gewährt über Facebook Login. Meta verlangt außerdem, dass Apps dem Nutzer einen Hinweis zeigen, wie seine Reels auf Facebook verwendet werden, mit Optionen zur Kontrolle, und dass sie nur die Zielgruppe Öffentlich anbieten, da das Veröffentlichen auf einer Seite einen impliziten öffentlichen Umfang hat.

Welche Fehler gibt die Reels API zurück?

Code 100 bedeutet, dass ein Pflichtparameter fehlt, etwa upload_phase, und Metas Meldung listet die fehlenden auf. Vier weitere Codes lehnen ein Video ab, das außerhalb der Vorgaben liegt:

  • 1363040: das Seitenverhältnis wird nicht unterstützt; Videos müssen zwischen 16x9 und 9x16 liegen.
  • 1363127: die Auflösung wird nicht unterstützt; das Minimum liegt bei 540 x 960 Pixeln.
  • 1363128: die Dauer wird nicht unterstützt; Reels laufen 3 bis 90 Sekunden.
  • 1363129: die durchschnittliche Bildrate wird nicht unterstützt; Reels brauchen 24 bis 60 Bilder pro Sekunde.

Wie listet man die Reels einer Seite auf?

Mit GET /{page-id}/video_reels, das die veröffentlichten Reels der Seite mit ihren IDs, Aktualisierungszeiten und Beschreibungen zurückgibt. since und until grenzen die Liste auf Daten ein, angegeben als today, yesterday, UNIX-Zeitstempel oder yyyy-mm-dd, wobei until nach since liegen muss. Die Feed-Referenz von Meta verweist für die auf einer Seite veröffentlichten Reels auf diesen Edge.

Wie veröffentlicht man ein Reel über easyCoexistence?

Derzeit nicht als Reel. publish_facebook_post sendet Videos an den Edge videos der Seite, als reguläre Videobeiträge, und easyCoexistence hat kein Tool für die video_reels-Aufrufe; Seiten-Tokens werden nicht herausgegeben, daher lassen sich die drei Schritte auch nicht aus Ihrem eigenen Code über seine Verbindung ausführen. Veröffentlichen Sie das Reel auf Facebook oder in Meta Business Suite, oder posten Sie das Video als regulären Videobeitrag.

Häufige Fehler

  • Den Upload an graph.facebook.com senden. Das Video geht an rupload.facebook.com mit dem Header Authorization: OAuth; nur Start-, Abschluss- und Statusaufrufe nutzen graph.facebook.com.
  • Die Datei dort hosten, wo Meta sie nicht abrufen kann. Eine file_url hinter einer Anmeldung, auf einer Seite, deren robots.txt facebookexternalhit/1.1 blockiert, oder auf fbcdn wird abgelehnt.
  • Nach einem unterbrochenen Upload von vorn beginnen. Lesen Sie zuerst den Status: uploading_phase.bytes_transfered ist der Offset, ab dem fortgesetzt wird, und eine neue Sitzung ist die letzte Option.
  • Mehr als 30 Reels für eine Seite an einem Tag einreihen. Meta zählt die über die API veröffentlichten Reels in einem gleitenden 24-Stunden-Zeitraum, also geplante Beiträge verteilen.
Mit EasyCoexistence

Für die Reels API gibt es kein Tool, ein Reel wird daher auf Facebook oder in Meta Business Suite veröffentlicht. US$ 9 bis US$ 0.75 pro verbundener Nummer und Monat, sinkend mit jeder weiteren Nummer, mit der kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Kann ein Reel über die API auf einem Facebook-Profil oder in einer Gruppe veröffentlicht werden?

Nein. Die Reels Publishing API von Meta veröffentlicht Reels nur auf Facebook-Seiten und verteilt sie nur per Crossposting auf Seiten.

Veröffentlicht publish_facebook_post Reels?

Nein. Die Funktion postet Text, Links, Fotos und Videos auf der Seite. Ein Reel braucht die video_reels-Aufrufe, die die Tools von easyCoexistence nicht ausführen.

Wie prüfe ich ein Reel auf Urheberrechtstreffer?

Lesen Sie GET /{video-id}?fields=copyright_check_information mit pages_read_engagement. Meta führt die Prüfung beim Upload aus, sie kann einige Minuten dauern, und nur der Eigentümer sieht die Treffer.

Kann eine andere Seite mein Reel ebenfalls veröffentlichen?

Ja, als Kollaborator. POST /{video-id}/collaborators mit target_id auf die ID ihrer Seite sendet eine Einladung, und sobald sie annimmt, erscheint das Reel auch auf deren Seite.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am