Facebook-Seiten-Stories-API: Foto- und Video-Stories über die API
Metas Stories-API veröffentlicht Foto- und Video-Stories auf einer Facebook-Seite. Eine Foto-Story benötigt ein Foto, das mit published auf false hochgeladen wurde, danach POST /{page-id}/photo_stories mit dessen photo_id. Eine Video-Story läuft über die Aufrufe start, upload und finish auf /{page-id}/video_stories. Video-Stories dauern bis zu 60 Sekunden, Fotos dürfen bis zu 10 MB groß sein.
easyCoexistence veröffentlicht die Beiträge einer Facebook-Seite mit publish_facebook_post aus Claude, ChatGPT oder Ihrem eigenen Code: Text, Links, Fotos und Videos.
Längste Video-Story, die Meta auf einer Facebook-Seite zulässt.
Größte Fotodatei für eine Foto-Story, als JPEG, BMP, PNG, GIF oder TIFF.
Seitenverhältnis der Video-Story, mit 1080 x 1920 Pixeln empfohlen und mindestens 540 x 960.
Status, den GET /{page-id}/stories meldet; archivierte Stories erscheinen nur, wenn das Story-Archiv der Seite aktiviert ist.
Wie wird eine Foto-Story veröffentlicht?
In zwei Schritten. Das Foto wird per POST /{page-id}/photos mit published auf false hochgeladen, was die ID des Fotos zurückgibt. Danach wird POST /{page-id}/photo_stories mit dieser photo_id gesendet. Meta antwortet mit success auf true und post_id, der ID des Story-Beitrags.
POST /{page-id}/photo_stories
{
"photo_id": "<PHOTO_ID>"
}
200 OK
{
"success": true,
"post_id": "<STORY_POST_ID>"
}Wie wird eine Video-Story veröffentlicht?
In drei Schritten, wie bei einem Reel. POST /{page-id}/video_stories mit upload_phase auf start liefert eine video_id und eine upload_url auf rupload.facebook.com. Das Video wird dorthin gesendet, als Dateibytes mit offset- und file_size-Headern oder als file_url-Header für eine gehostete Datei. Anschließend veröffentlicht POST /{page-id}/video_stories mit video_id und upload_phase auf finish die Story und gibt post_id zurück.
Welche Medien kann eine Story verwenden?
Der Stories-Leitfaden von Meta enthält eine Spezifikation für Fotos und eine für Videos. Fotos sind .jpeg-, .bmp-, .png-, .gif- oder .tiff-Dateien bis 10 MB, wobei PNG-Dateien möglichst unter 1 MB bleiben sollten. Videos folgen der Reels-Spezifikation mit einer kürzeren Obergrenze:
- Datei: .mp4 empfohlen, im Seitenverhältnis 9 x 16.
- Auflösung: 1080 x 1920 Pixel empfohlen, mindestens 540 x 960.
- Bildrate: 24 bis 60 Bilder pro Sekunde, konstant, mit progressiver Abtastung.
- Länge: höchstens 60 Sekunden für eine Video-Story.
- Codecs: H.264 oder H.265, VP9 und AV1 werden ebenfalls unterstützt; Audio in AAC Low Complexity mit 48 kHz, Stereo, 128 kbps oder mehr.
Welche Medien können für eine Story nicht verwendet werden?
Ein Foto oder Video, das bereits in einem früher veröffentlichten Beitrag verwendet wurde: Metas Regel besagt, dass Medien, die für eine Story hochgeladen werden, nicht zuvor veröffentlicht worden sein dürfen. Ein gehostetes Video muss zudem erreichbar sein, denn Meta lehnt Dateien auf Websites ab, deren robots.txt den User-Agent facebookexternalhit/1.1 blockiert, ebenso Dateien aus dem eigenen CDN von Meta, etwa fbcdn-URLs.
Wie werden die Stories einer Seite aufgelistet?
GET /{page-id}/stories liefert ein Objekt pro Story. Die Liste lässt sich nach Status oder Datum mit since und until filtern. Jedes Objekt enthält:
post_id: die ID des Story-Beitrags.- status: PUBLISHED oder ARCHIVED; archivierte Stories setzen voraus, dass das Story-Archiv der Seite aktiviert ist.
creation_time: der UNIX-Zeitstempel der Veröffentlichung.media_typeundmedia_id: Foto oder Video sowie die ID dieses Mediums.- url: die Facebook-Adresse der Story unter facebook.com/stories/.
Welche Berechtigungen werden benötigt?
Ein Seiten-Token von einer Person, die die Aufgabe CREATE_CONTENT auf der Seite ausführen darf, über Facebook Login oder Facebook Login for Business, mit den Berechtigungen pages_manage_posts, pages_read_engagement und pages_show_list. Anfragen, die als Business-Systembenutzer gestellt werden, benötigen zusätzlich business_management. Es sind dieselben drei Berechtigungen, die auch das Veröffentlichen im Feed der Seite verlangt.
Wann geht eine Story online?
Mit dem Aufruf photo_stories oder dem finish-Aufruf von video_stories. Die Stories-API von Meta kennt keine Veröffentlichungszeit: photo_stories nimmt eine photo_id entgegen, der finish-Aufruf nimmt video_id, upload_phase und das optionale Flag is_ai_generated. Eine Story für später braucht einen Aufruf zum gewünschten Zeitpunkt, ausgelöst durch einen eigenen Scheduler.
Wie veröffentlicht man eine Story über easyCoexistence?
Noch nicht. publish_facebook_post veröffentlicht Beiträge, keine Stories, und easyCoexistence hat kein Tool für photo_stories oder video_stories; Seiten-Tokens werden nicht herausgegeben, daher können die Aufrufe auch nicht aus Ihrem eigenen Code über dessen Verbindung laufen. Veröffentlichen Sie Stories über Facebook oder Meta Business Suite.
Häufige Fehler
- Ein Foto aus einem früheren Beitrag wiederverwenden. Medien für eine Story dürfen nicht aus einem zuvor veröffentlichten Beitrag stammen, daher laden Sie das Foto erneut mit published auf false hoch.
- Ein 90-Sekunden-Reel als Story verwenden. Reels dürfen bis zu 90 Sekunden lang sein, eine Video-Story endet jedoch bei 60.
- Archivierte Stories in der Liste erwarten. Sie erscheinen in GET /{page-id}/stories nur, wenn das Story-Archiv der Seite aktiviert ist.
- Das Video an graph.facebook.com senden. Der Upload gehört an die upload_url auf rupload.facebook.com; die Aufrufe start, finish und der Status bleiben auf graph.facebook.com.
Für die Stories-API gibt es kein Tool, daher werden Stories auf Facebook oder in Meta Business Suite veröffentlicht. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Kann ein Reel als Facebook-Seiten-Story geteilt werden?
Ja, wenn es höchstens 60 Sekunden lang ist. Laut Metas Spezifikation darf ein Reel, das als Story auf einer Seite veröffentlicht wird, diese Länge nicht überschreiten.
Lässt sich eine Video-Story als mit KI erstellt kennzeichnen?
Ja. Setzen Sie is_ai_generated im finish-Aufruf von video_stories auf true; der Standardwert ist false.
Was passiert, wenn der Video-Upload einer Story unterbrochen wird?
Senden Sie den Upload erneut mit offset auf 0, um neu zu starten, oder mit offset auf den Wert bytes_transfered aus einer Statusabfrage, um fortzusetzen.
Was kostet easyCoexistence für eine Facebook-Seite?
US$ 9 bis US$ 0.75 pro Verbindung und Monat, die ersten 3 Tage kostenlos. Jede Seite ist eine Verbindung, und der Preis pro Verbindung sinkt mit jeder weiteren.
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