Instagram Graph API

IG-Hashtag – Top-Medien

Stellt eine Collection der beliebtesten Foto- und Video-IG-Medien-Objekte dar, die mit einem Hashtag markiert wurden.

Die Beliebtheit wird durch eine Kombination aus Aufrufen und Betrachter*innen-Interaktionen bestimmt. Dabei wird die gleiche Methodik verwendet, mit der beim Suchen nach einem Hashtag auf www.instagram.com die Top-Beiträge ermittelt werden.

Bei Aufrufen mit Version 10.0 und älter bis zum 7. September 2021: Das Feld like_count bei IG-Medien gibt 0 zurück, wenn der Eigentümer des Mediums „Gefällt mir“-Angaben dafür verborgen hat.

Bei Aufrufen mit Version 11.0 und neuer sowie allen Versionen ab dem 7. September 2021: Bei der indirekten Abfrage eines IG-Medien-Objekts über einen anderen Endpunkt oder eine Felderweiterung wird das Feld like_count bei API-Antworten ausgelassen, wenn der Medien-Eigentümer „Gefällt mir“-Angaben dafür verborgen hat. Die direkte Abfrage des IG-Medien-Objekts (die nur durch den Eigentümer des IG-Medien-Objekts ausgeführt werden kann) gibt die tatsächliche Anzahl der „Gefällt mir“-Angaben zurück, auch wenn „Gefällt mir“-Angaben verborgen sind.

Erstellen

Dieser Vorgang wird nicht unterstützt.

Lesen

Abrufen der beliebtesten mit Hashtags markierten Medien

GET /{ig-hashtag-id}/top_media?user_id={user-id}&fields={fields}

Gibt die beliebtesten Foto- und Video-IG-Medien-Objekte zurück, die mit dem Hashtag markiert wurden.

Abfrage-String-Parameter

  • {user_id} (erforderlich) – Die ID des Instagram Business- oder Creator-Kontos, das die Abfrage durchführt.
  • {fields} – Eine durch Komma getrennte Liste der Felder, die zurückgegeben werden sollen. Siehe Felder, die zurückgegeben werden können.

Einschränkungen

  • Diese Edge gibt nur öffentliche Fotos und Videos zurück.
  • Hervorgehobene/beworbene/Werbeanzeigen-Medien werden nicht zurückgegeben.
  • Die Antworten sind paginiert, mit einem maximalen limit von 50 Ergebnissen pro Seite.
  • Du kannst höchstens 30 eindeutige Hashtags innerhalb eines Zeitraums von sieben Tagen abfragen.
  • Das Feld username von zurückgegebenen Medienobjekten kann nicht angefordert werden.
  • Dieser Endpunkt gibt nur einen after-Cursor für paginierte Ergebnisse zurück. Ein before-Cursor ist nicht enthalten. Außerdem ist der Wert des after-Cursors für alle Seiten gleich. Er kann aber trotzdem verwendet werden, um die nächste Seite mit Ergebnissen im Ergebnissatz abzurufen.

Anforderungen

TypBeschreibung

Features

Instagram Public Content Access

Berechtigungen

instagram_basic


Wenn der Schlüssel für einen Nutzer gilt, dessen Seitenrolle über den Business Manager erteilt wurde, ist außerdem eine der folgenden Berechtigungen erforderlich: ads_management, business_management oder pages_read_engagement.

Schlüssel

Einen Nutzer-Zugriffsschlüssel eines Facebook-Nutzers, der Aufgaben auf der verbundenen Facebook-Seite ausführen darf.

Antwort

Ein Array von IG-Medien-Objekten. Überzählige Ergebnisse werden paginiert.

Felder, die zurückgegeben werden können

Du kannst den fields-Parameter verwenden, um die folgenden Felder für zurückgegebene Medienobjekte anzufragen:

  • caption
  • children (wird nur für Album- IG-Medien-Objekte zurückgegeben)
  • comments_count
  • id
  • like_count (Aufrufe ab Version 10.0 und älter: Der Wert ist 0, wenn der*die Medieneigentümer*in die Anzahl an „Gefällt mir“-Angaben ausgeblendet hat. Aufrufe ab Version 11.0: Das Feld wird ausgelassen, wenn der*die Medieneigentümer*in die Anzahl an „Gefällt mir“-Angaben darin ausgeblendet hat.)
  • media_type
  • media_url (wird für Album- IG-Medien-Objekte nicht zurückgegeben)
  • permalink
  • timestamp (nur in v7.0+ verfügbar)

Beispielanfrage

GET graph.facebook.com/17873440459141021/top_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

Beispielantwort

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {       
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    },
    ... // Results truncated for clarity
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

Aktualisieren

Dieser Vorgang wird nicht unterstützt.

Löschen

Dieser Vorgang wird nicht unterstützt.