Instagram Basic Display API

Nutzermedien

Steht für eine Zusammenstellung von Medien zu einem Nutzer.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

GET /{user-id}/media

Ruf eine Zusammenstellung von Medien zu einem Nutzer ab.

Einschränkungen

  • Stories werden nicht unterstützt.
  • Medien in hervorgehobenen Beiträgen werden nicht unterstützt.
  • Gibt maximal 10K der zuletzt erstellten Medien zurück.

Anforderungen

TypAnforderung

Zugriffsschlüssel

Instagram-Nutzer

Berechtigungen

instagram_graph_user_media, instagram_graph_user_profile

Anfragesyntax

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

Pfadparameter

PlatzhalterWert

{api-version}
String

API-Version.

{user-id}
Erforderlicher
String

Die App-spezifische Nutzer-ID des App-Nutzers (Version 11.0 und neuer) oder die reine Nutzer-ID (alle Versionen).

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-Zugriffsschlüssel des App-Nutzers.

fields
Kommagetrennte Liste

Eine kommagetrennte Liste von Medienfeldern, die du für jeden Medien-Node im Ergebnissatz mit Felderweiterung abrufen möchtest.

since
Zeitstempel

Ein Unix-Zeitstempel oder strtotime Datenwert, der auf den Anfang eines Bereichs von zeitbasierten Daten verweist. Siehe zeitbasierte Paginierung.

until
Zeitstempel

Ein Unix-Zeitstempel oder strtotime Datenwert, der auf das Ende eines Bereichs von zeitbasierten Daten verweist. Siehe zeitbasierte Paginierung.

Antwort

Ein JSON-formatiertes Objekt, das die von dir angeforderten Daten enthält.

{
  "data": [],
  "paging": {}
}

Antwortinhalt

EigenschaftWert

data

Ein Array von Medien zum Nutzer.

paging

Ein Objekt mit Paginierungscursors und Abruf-URLs für den nächsten/vorherigen Datenset.

cURL-Beispiel

Anfrage

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171/media?access_token=IGQVJ...'

Antwort

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.