Instagram-Plattform

Medien

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Stellt ein Bild, Video oder Album dar.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{media-id}

Felder und Edges zu einem Bild, Video oder Album abrufen.

Anforderungen

TypAnforderung

Zugriffsschlüssel

Instagram-Nutzer*in

Berechtigungen

instagram_graph_user_media

Anfragesyntax

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

Abfrage-String-Parameter

Schließe die folgenden Abfrage-String-Parameter ein, um die Anfrage zu erweitern.

SchlüsselWert

access_token
Erforderlich
String

Der Instagram-Nutzer*innen-Zugriffsschlüssel des*der App-Nutzer*in.

fields
Kommagetrennte Liste

Eine durch Komma getrennte Liste der Felder und Edges, die zurückgegeben werden sollen. Wird keine Angabe gemacht, werden Standardfelder zurückgegeben.

Felder

Du kannst den fields-Abfrage-String-Parameter verwenden, um die folgenden Felder zu einem Medienelement anzufordern.

Name des FeldesBeschreibung

caption

Die Bildunterschrift des Medienelements. Kann nicht für Medien in Alben zurückgegeben werden. Hinweis: Bei der Verwendung von Emojis in Untertiteln sollte das Codierungsformat UTF-8 genutzt werden. Je nach verwendetem Emoji kann dies Einfluss auf die Zeichenlänge haben.

id

Die ID des Medienelements.

is_shared_to_feed

Nur für Reels. Wenn true festgelegt ist, kann das Reel auf den Tabs Feed und Reels angezeigt werden. Der Wert false gibt an, dass das Reel nur auf dem Tab Reels angezeigt werden kann.

Keiner der Werte gibt an, ob das Reel tatsächlich auf dem Tab Reels angezeigt wird, da das Reel möglicherweise nicht die Berechtigungsanforderungen erfüllt oder nicht von unserem Algorithmus ausgewählt wird. Die Berechtigungskriterien findest du unter Reel-Spezifikationen.

media_type

Der Medientyp. Dieser kann IMAGE, VIDEO oder CAROUSEL_ALBUM lauten.

media_url

Die Medien-URL.

permalink

Die permanente Medien-URL. Wird weggelassen, wenn das Medienobjekt urheberrechtlich geschützte Materialien enthält oder mit einer Urheberrechtsverletzung gekennzeichnet wurde.

thumbnail_url

Die URL des Miniaturbilds des Medienelements. Nur bei VIDEO-Medien verfügbar.

timestamp

Das Veröffentlichungsdatum des Medienelements im ISO-8601-Format.

username

Der Benutzungsname des*der Medieneigentümer*in.

Edges

Du kannst die folgenden Edges als Pfadparameter anfordern oder den fields-Abfrage-String-Parameter verwenden.

EdgeBeschreibung

children

Eine Liste von Medien zum Medienalbum abrufen. Nur bei CAROUSEL_ALBUM-Medien verfügbar.

Antwort

Ein JSON-formatiertes Objekt mit standardmäßigen und angeforderten Feldern und Edges.

{
  "{field}":"{value}",
  ...
}

cURL-Beispiel

Anfrage

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Antwort

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.