Hashtag-Suche

Finde öffentliche IG-Medien, die mit bestimmten Hashtags markiert wurden.

Einschränkungen

• Du kannst für ein Instagram Business- oder Creator-Konto höchstens 30 eindeutige Hashtags innerhalb von sieben Tagen abfragen. Wenn du ein Hashtag abfragst, wird dies sieben Tage lang auf diesen Grenzwert angerechnet. Nachfolgende Abfragen für denselben Hashtag innerhalb dieses Zeitraums werden nicht auf diesen Grenzwert angerechnet und setzen den ursprünglichen Abfrage-Timer von sieben Tagen nicht zurück.
• Mit einem Hashtag markierte Medienobjekte, die über die API gefunden wurden, kannst du nicht kommentieren.
• Für Stories werden keine Hashtags unterstützt.
• Emojis werden für Hashtag-Abfragen nicht unterstützt.
• Die API gibt einen generischen Fehler für alle Anfragen zurück, die Hashtags enthalten, die wir als vertraulich oder anstößig identifiziert haben.

Anforderungen

Um diese API verwenden zu können, musst du die App-Review absolvieren und eine Genehmigung für folgende Punkte anfordern:

• die Instagram Public Content Access-Funktion
• die instagram_basic-Berechtigung

Endpunkte

Die Hashtag Search API besteht aus den folgenden Nodes und Edges:

• GET /ig_hashtag_search – zum Abrufen der Node-ID eines bestimmten Hashtags
• GET /{ig-hashtag-id} – zum Abrufen von Daten zu einem Hashtag
• GET /{ig-hashtag-id}/top_media – zum Abrufen der beliebtesten Fotos und Videos, die über ein bestimmtes Hashtag verfügen
• GET /{ig-hashtag-id}/recent_media – zum Abrufen der zuletzt veröffentlichten Fotos und Videos, die über ein bestimmtes Hashtag verfügen
• GET /{ig-user-id}/recently_searched_hashtags – zum Ermitteln der eindeutigen Hashtags, nach denen ein Instagram Business- oder Creator-Konto in der aktuellen Woche gesucht hat

Informationen zu Anforderungen an unterstützte Felder, Parameter und Nutzungsberechtigungen findest du in der Referenzdokumentation zu den einzelnen Endpunkten.

Häufige Anwendungsfälle

Abrufen von mit Hashtag gekennzeichneten Medien

Um alle Fotos und Videos abzurufen, die mit einem bestimmten Hashtag gekennzeichnet sind, verwendest du zuerst den /ig_hashtag_search-Endpunkt und nimmst das Hashtag und die ID des Instagram Business- oder Creator-Kontos in die Abfrage auf. Wenn die Anfrage zum Beispiel für das Instagram Business-Konto mit der ID 17841405309211844 erfolgt, könntest du die ID für das Hashtag „#coke“ mit der folgenden Abfrage ermitteln:

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

Hiermit wird die ID des Hashtag-Nodes „#Coke“ zurückgegeben:

{
  "id" : "17873440459141021"
}

Nachdem du nun die Hashtag-ID (17873440459141021) erhalten hast, kannst du deren /top_media- oder /recent_media-Edge abfragen und die Business-Konto-ID aufnehmen, um eine Collection mit Medienobjekten zu erhalten, die mit dem Hashtag „#coke“ gekennzeichnet sind. Beispiel:

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

Hiermit wird eine Antwort ähnlich der folgenden zurückgegeben:

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}