IG-Nutzer*innenmedien

Stellt eine Collection von IG-Medien-Objekten für eine*n IG-Nutzer*in dar.

Erstellen

POST /{ig-user-id}/media

• Erstelle einen Bild-, Carousel-, Story- oder Reel-IG-Container, um ihn im Prozess nach der Veröffentlichung zu verwenden. Die vollständigen Schritte zur Veröffentlichung findest du im Leitfaden zur Content-Veröffentlichung.

Einschränkungen

Allgemeine Einschränkungen

• Container verfallen nach 24 Stunden.
• Wenn die mit dem professionellen Instagram-Zielkonto verbundene Seite eine Page Publishing Authorization (PPA) erfordert, muss die PPA durchgeführt werden. Andernfalls schlägt die Anfrage fehl.
• Wenn die mit dem professionellen Instagram-Zielkonto verbundene Seite zweistufige Authentifizierung erfordert, muss der*die Facebook-Nutzer*in ebenfalls eine zweistufige Authentifizierung durchgeführt haben. Andernfalls schlägt die Anfrage fehl.
• Das Veröffentlichen auf Instagram TV wird nicht unterstützt.

Einschränkungen für Reels

• Reels können nicht in Album-Carousels angezeigt werden.
• Privatsphäre-Einstellungen für Konten werden bei Veröffentlichung umgesetzt. Beispiel: Wenn Remixen erlauben aktiviert ist, ist bei veröffentlichten Reels durch die Veröffentlichung Remixing aktiviert, kann jedoch bei veröffentlichten Reels über die Instagram-App manuell deaktiviert werden.
• Das Markieren von Musik ist nur für Original-Audio verfügbar.

Einschränkungen für Stories

• Stories laufen nach 24 Stunden ab.
• Sie unterstützen entweder eine Video-URL oder eine Reels-URL, nicht beides.
• Das Veröffentlichen von Stickern (also Link, Umfrage, Standort) wird nicht unterstützt.

Anforderungen

Spezifikationen für Bilder

• Format: JPEG
• Dateigröße: max. 8 MB.
• Seitenverhältnis: muss im Bereich zwischen 4:5 und 1,91:1 liegen
• Mindestbreite: 320 (wird bei Bedarf auf den Mindestwert vergrößert)
• Maximale Breite: 1440 (wird bei Bedarf auf den Höchstwert verkleinert)
• Höhe: variiert in Abhängigkeit vom Seitenverhältnis
• Farbraum: sRGB. Für Bilder, die andere Farbräume verwenden, wird der Farbraum in sRGB konvertiert.

Reel-Spezifikationen

Spezifikationen für Reels:

• Container: MOV oder MP4 (MPEG-4 Part 14), keine Bearbeitungslisten, moov-Atom am Anfang der Datei.
• Audio-Codec: AAC, maximale Abtastrate 48 kHz, 1 oder 2 Kanäle (Mono oder Stereo).
• Video-Codec: HEVC oder H264, Progressive Scan, geschlossene GoP, Farbunterabtastung 4:2:0.
• Frame-Frequenz: 23 bis 60 FPS.
• Bildgröße:

  • Max. Spalten (horizontale Pixel): 1920
  • Das erforderliche Seitenverhältnis liegt zwischen 0,01:1 und 10:1. Wir empfehlen jedoch 9:16, um Zuschneiden oder leere Bereiche zu vermeiden.
• Video-Bitrate: VBR, max. 25 Mbit/s
• Audio-Bitrate: 128 Kbit/s
• Dauer: max. 15 Minuten, min. 3 Sekunden
• Dateigröße: max. 1 GB

Spezifikationen für Reels-Titelbild:

• Format: JPEG
• Dateigröße: max. 8 MB
• Farbraum: sRGB. Für Bilder, die andere Farbräume verwenden, wird der Farbraum in sRGB konvertiert.
• Seitenverhältnis: Wir empfehlen 9:16, um Zuschneiden oder leere Bereiche zu vermeiden. Wenn das Seitenverhältnis des Originalbildes nicht 9:16 ist, schneiden wir das Bild zu und verwenden das Rechteck mit 9:16 aus der Mitte als Titelbild für das Reel. Wenn du ein Reel in deinem Feed teilst, schneiden wir das Bild zu und verwenden das Quadrat mit 1:1 aus der Mitte als Titelbild für deinen Feed-Beitrag.

Spezifikationen für Bilder in Stories

• Format: JPEG
• Dateigröße: max. 8 MB
• Seitenverhältnis: Wir empfehlen 9:16, um Zuschneiden oder leere Bereiche zu vermeiden.
• Farbraum: sRGB. Für Bilder, die andere Farbräume verwenden, wird der Farbraum in sRGB konvertiert.

Spezifikationen für Videos in Stories

• Container: MOV oder MP4 (MPEG-4 Part 14), keine Bearbeitungslisten, moov-Atom am Anfang der Datei.
• Audio-Codec: AAC, maximale Abtastrate 48 kHz, 1 oder 2 Kanäle (Mono oder Stereo).
• Video-Codec: HEVC oder H264, Progressive Scan, geschlossene GoP, Farbunterabtastung 4:2:0.
• Frame-Frequenz: 23 bis 60 FPS.
• Bildgröße:

  • Max. Spalten (horizontale Pixel): 1920.
  • Das erforderliche Seitenverhältnis liegt zwischen 0,01:1 und 10:1. Wir empfehlen jedoch 9:16, um Zuschneiden oder leere Bereiche zu vermeiden.
• Video-Bitrate: VBR, max. 25 Mbit/s
• Audio-Bitrate: 128 Kbit/s
• Dauer: max. 60 Sekunden, min. 3 Sekunden
• Bildgröße: max. 100 MB

Anfragesyntax

Bildcontainer

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

Reel-Container

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

Carousel-Container

Nur Carousel-Container. Um Container für Carousel-Elemente zu erstellen, erstelle stattdessen Bild- oder Videocontainer (Reels werden nicht unterstützt). Die umfassenden Veröffentlichungsschritte findest du unter Carousel-Beiträge.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

Container für Story mit Bild

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

Container für Story mit Video

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

Pfadparameter

Abfrage-String-Parameter

Antwort

Ein JSON-formatiertes Objekt, das eine IG-Container-ID enthält, mit der du den Container veröffentlichen kannst.

Video-Uploads sind nicht synchron. Daher ist der Erhalt der Container-ID keine Garantie für einen erfolgreichen Upload. Um zu überprüfen, ob ein Video hochgeladen wurde, frage das Feld status_code im IG-Container ab. Ist der Wert FINISHED, wurde das Video erfolgreich hochgeladen.

{
  "id":"{ig-container-id}"
}

Beispielanfrage

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

Beispielantwort

{
  "id": "17889455560051444"
}

Lesen

GET /{ig-user-id}/media

Ruft alle IG-Medien für eine*n IG-Nutzer*in ab.

Einschränkungen

• Gibt maximal 10K der zuletzt erstellten Medien zurück.
• Story-IG-Medien werden nicht unterstützt. Verwende hierfür stattdessen den Endpunkt GET /{ig-user-id}/stories.

Anforderungen

Zeitbasierte Paginierung

Dieser Endpunkt unterstützt die zeitbasierte Paginierung. Schließe die Abfrage-String-Parameter since und until mit Unix-Zeitstempel oder strtotime-Datenwerten ein, um eine Zeitspanne zu definieren.

Beispielanfrage

GET graph.facebook.com/17841405822304914/media 

Beispielantwort

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.