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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
hashtags | Erforderlich | Ein oder mehrere nicht leere Hashtags, mit oder ohne #, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximal angeforderte Datensätze pro Hashtag; Standardwert 100, zulässig sind ganze Zahlen von 10 bis 2.000. |
published_within | Optional | Optionaler Veröffentlichungszeitraum: hour, day, week, month oder year. |
media_type | Optional | Inhaltsfilter; 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.
- Bereiten Sie einen oder mehrere eindeutige Hashtags vor, mit oder ohne führendes #.
- Senden Sie hashtags und optional die Felder results_limit, published_within und media_type per POST an /v1/instagram/hashtag-posts.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded oder failed lautet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Account Age Checker API