tiktok/
hashtags

Öffentliche TikTok-Videos zu einem oder mehreren Hashtags erfassen – mit normalisiertem Kontext zu Creator, Bildunterschrift, Medien, Sound, Interaktion und passendem Hashtag.

TikTok Hashtags API

Kampagnen-Tracking
Community-Inhalte
Tag-Vergleich
0,7 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

TikTok Hashtags

TikTok Hashtags sind Themenlabels, die öffentliche Videos rund um eine gemeinsame Wendung, Kampagne, Veranstaltung oder ein gemeinsames Interesse verbinden – mit Signalen zu Creator, Inhalt, Medien, Sound und Interaktion. Diese Datensätze eignen sich für die Entdeckung von Trends, die Beobachtung von Themen, die Kampagnenrecherche und die Zielgruppenanalyse.

Funktionen der TikTok Hashtags API

  • Parallele Erfassung von HashtagsSenden Sie mehrere Hashtags zu Kampagnen, Marken oder Communities parallel.
  • Normalisierte Hashtag-EingabenVereinheitlicht #campaign und campaign zu einem konsistenten Tag-Format.
  • Ergebnislimits pro TagWenden Sie results_limit pro Tag an, um die Stichproben klar zu planen.
  • Kontext des passenden HashtagsBehält die übergebene Gruppe über matched_hashtag bei jedem Video bei.
  • Vergleichbare VideodatensätzeVergleichen Sie Hashtag-Aufrufe, Creator, Creative-Elemente und Video-Interaktionen in einer einheitlichen Datenstruktur.

Parameter der TikTok Hashtags API

ParameterErforderlichBeschreibung
hashtagsErforderlichErforderliche Liste ausdrücklicher Hashtag-Werte mit optionalem führendem #.
results_limitOptionalPositives angefordertes Limit an Videos pro Hashtag. Standardwert ist 100.

So verwenden Sie die TikTok Hashtags API

Listen Sie die zu verfolgenden Tags auf, legen Sie für jedes eine Stichprobengröße an Videos fest und bauen Sie einen Datensatz auf, der für den Gruppenvergleich bereit ist.

  1. Sammeln Sie Tags zu Kampagnen, Marken oder Communities, normalisieren Sie space und #space und entfernen Sie dann Duplikate.
  2. Senden Sie hashtags und results_limit per POST an /v1/tiktok/hashtags und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder fehlschlägt.
  4. Lesen Sie data.results.items. Ist has_more gleich true, machen Sie mit next_cursor weiter.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["space","#astronomy"],"results_limit":100}'

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

Anwendungsfälle der TikTok Hashtags API

  • Tracking von UGC-Kampagnen: Erfassen Sie die Beteiligung unter offiziellen Kampagnen-Tags und untersuchen Sie Creator-Reichweite, inhaltliche Ausrichtung und Verteilung der Interaktion.
  • Asset-Verzeichnisse zu Marken-Tags: Machen Sie Videos zu Marken- und Produkt-Hashtags zu einer durchsuchbaren Bibliothek für Marketing- und Social-Media-Teams.
  • Profile von Interessen-Communities: Nutzen Sie Creator, Bildunterschriften, Musik und Interaktion, um die Inhaltskultur rund um ein Interessen-Tag zu verstehen.
  • Vergleich von Hashtag-Kohorten: Erfassen Sie mehrere Tags parallel und vergleichen Sie Creator-Mix, Creative-Elemente und Leistung über die Gruppen hinweg.

Profi-Tipps zur TikTok Hashtags API

  • Entfernen Sie das führende #, vereinheitlichen Sie die Groß- und Kleinschreibung und entfernen Sie Duplikate, damit jedes Tag eine klare Stichprobengruppe bildet.
  • Verwenden Sie die Anzahl der Tags multipliziert mit results_limit als angefordertes Maximum und nicht als garantierte Gesamtzahl der Ergebnisse.
  • Behalten Sie matched_hashtag bei, damit Videos, die über mehrere Gruppen erfasst wurden, eine vollständige Herkunft behalten.
  • Verwenden Sie beim Vergleich von Hashtag-Kohorten dasselbe results_limit und denselben Erfassungszeitpunkt.
  • Behandeln Sie die Aufrufzahl des Hashtags und die Interaktionskennzahlen jedes Videos als getrennte Momentaufnahmen.
  • Reichern Sie häufig auftretende Creator mit Daten aus Profiles an, um den Creator-Mix zu verstehen, den jedes Tag anzieht.

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

  • TikTok Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • TikTok Search API — Öffentliche Videos per Keyword suchen – mit unterstützten Sortier- und Veröffentlichungsfiltern.
  • TikTok Live Room Info API — Einen bekannten Livestream anhand des Paars aus Raum-ID und Besitzer-ID nachschlagen und Status, Besitzerkontext, Cover-Medien und Zuschauerzahlen zurückgeben.
  • TikTok Search Users API — Öffentliche TikTok-Konten per Keyword suchen.
  • TikTok Hashtag Views API — Gesamtzahl der Videos und Aufrufe für bis zu 20 Hashtags auf einmal abfragen.

Weitere Plattformen entdecken

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

TikTok Hashtags API — FAQ

TikTok Hashtags API erfasst öffentlich zugängliche Videos zu einem oder mehreren angegebenen TikTok-Hashtags. Zurückgegeben werden normalisierte Daten zu Video, Creator, Bildunterschrift, Medien, Sound, Interaktion und passendem Hashtag.

Tragen Sie die Tag-Namen in das Array hashtags ein. Sowohl fyp als auch #fyp werden akzeptiert, und das führende # wird vor der Erfassung normalisiert.

Ja. hashtags akzeptiert mehrere Tag-Namen, die in derselben asynchronen Aufgabe getrennt erfasst werden.

results_limit gilt separat für jedes übergebene Tag und hat den Standardwert 100. Drei Tags mit dem Wert 100 fordern bis zu 100 Videos pro Tag an.

matched_hashtag hält fest, welches übergebene Tag das Video geliefert hat, und lässt sich mit der öffentlichen Aufrufzahl des Hashtags für Zuordnung und gruppierte Analysen kombinieren.

Die Ergebnisse enthalten Video-ID, URL, Bildunterschrift, Veröffentlichungszeitpunkt, Creator, öffentliche Interaktion, Hashtags, Erwähnungen, Medien, Musik und Erfassungszeitpunkt.

Gruppieren Sie die Ergebnisse nach matched_hashtag und vergleichen Sie dann Creator-Mix, Bildunterschriften, Musik, Hashtag-Aufrufe und Video-Interaktion über die Gruppen hinweg.

Jedes zurückgegebene normalisierte Hashtag-Videoergebnis kostet 0,7 Credits.