instagram/
hashtag-posts

Öffentliche Instagram-Beiträge zu einem oder mehreren Hashtags erfassen – mit Autorendetails, Bildunterschriften, Medien, Quell-Hashtags, Zeitstempeln und sichtbaren Interaktionskennzahlen.

Instagram Hashtag Posts API

Hashtag-Recherche
Beitragsdatensätze
Zeit- und Medienfilter
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Instagram Hashtag Posts

Instagram-Hashtag-Beiträge sind öffentliche Fotos oder Reels, die einem gesuchten Hashtag zugeordnet sind, mit Bildunterschriften, Creator-Identität, Medien, Zeitstempeln und sichtbarer Interaktion. Diese Inhalts- und Herkunftssignale unterstützen Themenrecherche, Vergleiche zwischen Hashtags, Creator-Recherche und zeitlich begrenztes Monitoring.

Funktionen der Instagram Hashtag Posts API

  • Erfassung über mehrere HashtagsÜbergeben Sie einen oder mehrere Hashtags mit oder ohne #; results_limit gilt getrennt für jeden übergebenen Hashtag.
  • Zeit- und MedienfilterBegrenzen Sie die Suche auf die letzte Stunde, den letzten Tag, die letzte Woche, den letzten Monat oder das letzte Jahr und wählen Sie alle Beiträge oder nur Reels.
  • Normalisierte BeitragsdatensätzeSie erhalten Beitrags-IDs, Shortcodes, kanonische URLs, Bildunterschriften, Autorendetails, Medienverweise, Hashtags, Erwähnungen und Zeitstempel in einer einheitlichen Form.
  • Quellkontext und InteraktionBehält den übergebenen Hashtag, der den jeweiligen Datensatz geliefert hat, zusammen mit den verfügbaren Zahlen zu Likes, Kommentaren, Aufrufen und Wiedergaben bei.

Parameter der Instagram Hashtag Posts API

ParameterErforderlichBeschreibung
hashtagsErforderlichEin oder mehrere nicht leere Hashtags, mit oder ohne #, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximal angeforderte Datensätze pro Hashtag; Standardwert 100, zulässig sind ganze Zahlen von 10 bis 2.000.
published_withinOptionalOptionaler Veröffentlichungszeitraum: hour, day, week, month oder year.
media_typeOptionalInhaltsfilter; all umfasst die unterstützten Beitragstypen, reels beschränkt die Ergebnisse auf Reels.

So verwenden Sie die Instagram Hashtag Posts API

Senden Sie Hashtags als asynchrone Aufgabe, fragen Sie die Aufgaben-ID ab und lesen Sie die normalisierten Beitragsdatensätze per Cursor-Paginierung aus.

  1. Bereiten Sie einen oder mehrere eindeutige Hashtags vor, mit oder ohne führendes #.
  2. Senden Sie hashtags und optional die Felder results_limit, published_within und media_type per POST an /v1/instagram/hashtag-posts.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
  4. Lesen Sie /v1/tasks/{task_id}?limit=50 und folgen Sie results.next_cursor, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/instagram/hashtag-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Instagram Hashtag Posts API

  • Entdeckung von Themeninhalten: Erstellen Sie prüfbare Datensätze öffentlicher Beiträge zu Hashtags aus Kampagnen, Events, Communitys oder Branchen.
  • Vergleich zwischen Hashtags: Vergleichen Sie sichtbare Interaktion und Inhaltsmuster und behalten Sie dabei zu jedem Datensatz den übergebenen Hashtag, der ihn geliefert hat.
  • Monitoring aktueller Reels: Kombinieren Sie einen Veröffentlichungszeitraum mit dem Filter „nur Reels“, um aktuelle Kurzvideo-Inhalte zu ausgewählten Hashtags zu prüfen.
  • Anreicherung von Creator- und Inhaltsdaten: Verknüpfen Sie Beitragsidentität, Autorenkontext, Bildunterschriften, Medien und sichtbare Kennzahlen mit Recherche-, Kampagnen- oder Moderationsdatensätzen.

Profi-Tipps zur Instagram Hashtag Posts API

  • Entfernen Sie doppelte Hashtags aus der Eingabe und verwenden Sie pro Thema eine Schreibweise; der Collector verarbeitet jeden übergebenen Wert unabhängig.
  • Planen Sie die Datenmenge pro Hashtag, denn results_limit gilt für jeden Hashtag und nicht für die Anfrage insgesamt.
  • Nutzen Sie published_within und media_type gemeinsam, wenn ein wiederkehrendes Monitoring einen einheitlichen Zeitraum und Inhaltstyp braucht.
  • Entfernen Sie überlappende Ergebnisse anhand stabiler Beitrags-IDs, Shortcodes oder kanonischer URLs und behalten Sie extra.hashtag zur Herkunft bei.
  • Behandeln Sie Medien, Zähler, Zeitstempel und andere öffentliche Felder als optional, denn die Verfügbarkeit in der Quelle kann je Beitrag schwanken.

Ergänzend zur Instagram Hashtag Posts API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Instagram-Daten benötigen.

  • Instagram Search API — Öffentliche Profile per Keyword oder Handle suchen – mit Identität und sichtbaren Kontosignalen.
  • Instagram Comments API — Öffentliche Kommentare, Autoren, Zeitstempel, Likes und Antworten aus Beitrags-URLs erfassen.
  • Instagram Profiles API — Öffentliche Profilidentität, Bios, Links, Kontomerkmale, Kategorien und sichtbare Zahlen per Benutzername abrufen.
  • Instagram Post Info API — Bekannte öffentliche Beitrags-, Reel- oder ältere IGTV-URLs nachschlagen – mit Bildunterschriften, Autorenidentität, Medien, Zeitstempeln, sichtbaren Interaktionen und Eingabekontext.
  • Instagram Reels Search API — Öffentliche Reels per Textsuche finden – mit Bildunterschriften, Creators, Medien, Zeitstempeln, sichtbaren Interaktionen und Suchkontext.
  • Instagram Hashtag Search API — Hashtags zu einem Keyword finden – mit Hashtag-Namen, IDs, URLs der Hashtag-Seiten und öffentlichen Beitragszahlen.

Weitere Plattformen entdecken

Kombinieren Sie Instagram-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Instagram Hashtag Posts API — FAQ

Instagram Hashtag Posts API ist eine Schnittstelle zum Abrufen öffentlicher Instagram-Beiträge, die einem oder mehreren übergebenen Hashtags zugeordnet sind. Sie liefert normalisierte Beitragsidentität, Bildunterschriften, Autoren, Medien, Zeitstempel, Kontext des Quell-Hashtags und sichtbare Interaktionskennzahlen.

Senden Sie ein nicht leeres Array hashtags; die Werte können das führende # enthalten oder weglassen. results_limit akzeptiert 10 bis 2.000, hat den Standardwert 100 und gilt getrennt für jeden Hashtag.

published_within akzeptiert hour, day, week, month oder year. media_type akzeptiert all oder reels; ohne Angabe gilt all.

Ein normalisiertes Ergebnis kann ID, Shortcode, URL, Bildunterschrift, Autor, Medien, Hashtags, Erwähnungen, created_at, collected_at, die sichtbaren Zahlen zu Likes, Kommentaren, Aufrufen und Wiedergaben sowie extra.hashtag für die passende Eingabe enthalten.

Die Abrechnung beträgt 0,5 Credits pro zurückgegebenem normalisiertem Datensatz, ohne Grundgebühr. Schätzungen multiplizieren das results_limit pro Hashtag mit der Anzahl der übergebenen Hashtags; die endgültige Nutzung richtet sich nach den tatsächlich zurückgegebenen Datensätzen.