AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram-Hashtag-Suche über die API: Beiträge nach Hashtag finden

Die Hashtag-Suche von Instagram findet öffentliche Fotos und Videos mit einem Hashtag, in zwei Aufrufen. GET /ig_hashtag_search mit user_id und q liefert die ID des Hashtags, danach listet GET /<HASHTAG_ID>/top_media die beliebtesten Beiträge und /recent_media die der letzten 24 Stunden. Ein Konto kann 30 eindeutige Hashtags innerhalb von rollierenden 7 Tagen abfragen, mit Facebook Login oder Unified Login.

easyCoexistence verbindet Instagram über Instagram Login, sodass Claude, ChatGPT oder Ihr eigener Code über die offizielle API von Meta mit den eigenen Beiträgen, Kommentaren, Erwähnungen und Insights des Kontos arbeiten kann.

30

Eindeutige Hashtags, die ein Unternehmens- oder Creator-Konto innerhalb eines rollierenden 7-Tage-Zeitraums abfragen kann.

24 hours

recent_media liefert nur Medien, die innerhalb von 24 Stunden vor der Abfrage veröffentlicht wurden.

50

Die höchste Anzahl an Ergebnissen pro Seite liefert top_media, das nur mit einem after-Cursor blättert.

Not supported

Hashtag-Suche mit der Instagram API über Instagram Login, laut Metas Vergleich der drei Setups.

Static

Hashtag-IDs sind statisch und global: Ein Hashtag behält für jede App und jeden Nutzer dieselbe ID.

Wie funktioniert die Hashtag-Suche?

In zwei Schritten, im Auftrag eines Instagram-Unternehmens- oder Creator-Kontos, dessen ID in user_id steht. GET /ig_hashtag_search mit q auf den Namen des Hashtags gesetzt liefert dessen ID, die Meta als statisch und global bezeichnet, sodass sie gespeichert werden kann. Danach listet GET /<HASHTAG_ID>/top_media oder /recent_media mit user_id und fields die Beiträge auf.

Finding a hashtag's ID, then its recent posts
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee

{ "data": [ { "id": "<HASHTAG_ID>" } ] }

GET /<HASHTAG_ID>/recent_media
  ?user_id=<IG_ID>
  &fields=id,media_type,permalink,timestamp,like_count,comments_count

Worin unterscheiden sich top_media und recent_media?

top_media liefert die beliebtesten Fotos und Videos mit dem Hashtag; Meta bewertet die Beliebtheit anhand einer Mischung aus Aufrufen und Interaktion der Betrachter. recent_media liefert die zuletzt veröffentlichten, beschränkt auf Medien, die innerhalb von 24 Stunden vor der Abfrage veröffentlicht wurden. Meta weist darauf hin, dass die Antworten nicht immer chronologisch sortiert sind. Beide liefern nur öffentliche Medien, lassen beworbene, geboostete und Werbemedien aus und blättern jeweils 50 Ergebnisse weiter, mit einem after-Cursor.

Welche Felder werden zurückgegeben?

Die Medienfelder, die Metas Referenzen für beide Edges auflisten, die nur öffentliche Fotos und Videos liefern:

  • id, media_type (CAROUSEL_ALBUM, IMAGE oder VIDEO), permalink und timestamp.
  • caption und comments_count sowie like_count, außer der Eigentümer hat Like-Zahlen ausgeblendet.
  • children bei Album-Medien und media_url bei anderen Medien, aber nicht bei Videos mit urheberrechtlich geschütztem oder lizenziertem Audio.
  • Kein username: Meta erlaubt ihn bei Medien aus der Hashtag-Suche nicht.

Welche Limits gelten?

Meta setzt sie pro Konto und pro Hashtag:

  • 30 eindeutige Hashtags innerhalb von rollierenden 7 Tagen. Ein Hashtag zählt ab seiner ersten Abfrage; erneutes Abfragen in diesem Zeitraum wird nicht gezählt und startet seine 7 Tage nicht neu.
  • Das Abrufen von top_media oder recent_media zählt als Abfrage des Hashtags, auch wenn seine ID bereits gespeichert ist.
  • GET /<IG_ID>/recently_searched_hashtags listet die eindeutigen Hashtags auf, die das Konto in der laufenden Woche gesucht hat.
  • Hashtags in Stories und Emojis in Abfragen werden nicht unterstützt, und Hashtags, die Meta als sensibel oder anstößig einstuft, liefern einen allgemeinen Fehler.
  • Über die API gefundene Medien können nicht über die API kommentiert werden.

Was braucht die Hashtag-Suche?

Die Genehmigung durch App Review für das Feature Instagram Public Content Access und die Berechtigung instagram_basic, die Meta verlangt, bevor eine App sie nutzen kann, sowie ein User Access Token aus Facebook Login für eine Person, die Aufgaben auf der verknüpften Seite ausführen kann, oder ein Unified-Login-Token. Metas Übersicht führt die Hashtag-Suche mit Instagram Login als nicht unterstützt, und ihre Aufrufe fallen unter die Rate Limits der Plattform von Meta statt unter das Aufrufbudget pro Konto von Instagram. Die erlaubten Einsatzzwecke, die Meta nennt, sind das Finden von Inhalten aus Ihren Hashtag-Kampagnen, das Verstehen der öffentlichen Stimmung zu Ihrer Marke und das Ermitteln von Teilnehmern an Gewinnspielen.

Können Sie Hashtags über easyCoexistence suchen?

easyCoexistence verbindet Instagram über Instagram Login, das auf die eigenen Beiträge, Kommentare, Erwähnungen und Insights des verbundenen Kontos zugreift. Meta bietet die Hashtag-Suche nur mit Facebook Login und Unified Login an, daher liegt sie außerhalb dieser Verbindung. Stattdessen deckt die Verbindung Folgendes ab: die eigenen Beiträge des Kontos über list_social_posts sowie dessen Kommentare und Erwähnungen, die an Ihren Endpoint weitergeleitet werden, sobald sie eintreffen.

Häufige Fehler

  • Das Wochenkontingent für Tests aufbrauchen. Jeder neue Hashtag zählt zu den 30 in 7 Tagen, und das Abrufen seiner Medien zählt auch bei gespeicherter ID.
  • username bei Hashtag-Ergebnissen anfordern. Meta liefert ihn nicht für Medien, die über die Hashtag-Suche gefunden wurden.
  • recent_media als Archiv lesen. Es umfasst Medien, die in den 24 Stunden vor der Abfrage veröffentlicht wurden, und nicht in strikter chronologischer Reihenfolge.
  • Mit einem Instagram-Login-Token aufrufen. Meta kennzeichnet die Hashtag-Suche in diesem Setup als nicht unterstützt.
Mit EasyCoexistence

Kommentare und Erwähnungen lassen sich zudem an Ihren Endpoint weiterleiten, sobald sie eintreffen. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit den ersten 3 Tagen in der kostenlosen Testphase.

Häufig gestellte Fragen

Kann die Instagram API Hashtags ohne App Review durchsuchen?

Nein. Meta verlangt die Genehmigung durch App Review für das Feature Instagram Public Content Access und für instagram_basic, bevor eine App die Hashtag-Suche aufrufen kann.

Kann ich sehen, wer mit einem Hashtag gepostet hat?

Nicht über den username, den Meta in Hashtag-Ergebnissen weglässt. Der Permalink jedes Beitrags öffnet ihn auf Instagram.

Schließt die Hashtag-Suche Stories ein?

Nein. Meta unterstützt keine Hashtags in Stories, und beide Edges liefern nur öffentliche Fotos und Videos.

Zählt eine erneute Abfrage desselben Hashtags doppelt?

Nein. Wiederholte Abfragen innerhalb seiner 7 Tage werden nicht auf die 30 angerechnet und starten den Timer des Hashtags nicht neu.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am