tiktok-creative-center/
trending-hashtag-detail

Einen Trend-Hashtag auf TikTok per Creative-Center-ID nachschlagen: Beitrags- und Aufrufzahlen, tägliche Beliebtheitskurve, Top-Länder nach Wert und Beispiel-Video-IDs.

TikTok Creative Center Hashtag Insights API

Hashtag-ID als Eingabe
Top-Länder
Beispielvideos
0,5 Credits pro Anfrage
Bereit
README

Von SocQ · Aktualisiert am

TikTok Creative Center Hashtag Insights

Eine Hashtag-Insights-Auswertung des Creative Center porträtiert einen Trend-Tag in einem Markt: seine Beitrags- und Aufrufzahlen, eine tägliche Beliebtheitskurve, die Länder, in denen er im Verhältnis zu ihrer Größe am beliebtesten ist, und Beispielvideos, die ihn verwenden. Zusammen zeigen sie, wie sich ein Trend bewegt, wo er sonst noch Anklang findet und welche Art von Inhalten ihn trägt.

Funktionen der TikTok Creative Center Hashtag Insights API

  • Ein Tag, nachgeschlagen per IDhashtag_id nimmt die id eines Ergebnisses von Trending Hashtags entgegen und liefert einen einzelnen Datensatz zu diesem Tag im gewählten country und time_range.
  • Kurve und Zahlen für das Fensterpopularity_curve liefert pro Tag einen datierten Wert von 0 bis 100, daneben metrics.posts_count und metrics.views_count.
  • Länder nach Wert geordnettop_countries listet country_code und score auf, den höchsten zuerst; der Wert spiegelt die Beliebtheit im Verhältnis zur Größe des Landes.
  • Beispiel-Video-IDsvideo_ids listet Videos auf, die den Tag verwenden, und zeigt, auf welchen Inhalten der Trend aufbaut.

Parameter der TikTok Creative Center Hashtag Insights API

ParameterErforderlichBeschreibung
hashtag_idErforderlichHashtag-ID aus einem Ergebnis von TikTok Creative Center Trending Hashtags.
countryOptionalZweistelliger Ländercode des Marktes, etwa US, GB oder JP. Standard ist US.
time_rangeOptionalZu analysierender Zeitraum: 7d (Standard), 30d oder 90d.

So verwenden Sie die TikTok Creative Center Hashtag Insights API

Nehmen Sie eine Hashtag-ID aus dem Trend-Ranking und lesen Sie ihre Auswertung aus.

  1. Erfassen Sie Hashtags mit TikTok Creative Center Trending Hashtags und kopieren Sie eine id.
  2. Senden Sie {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} per POST an /v1/tiktok-creative-center/trending-hashtag-detail.
  3. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie den einzelnen Datensatz in results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'

# top_countries lists {country_code, score}; video_ids lists example videos.

Anwendungsfälle der TikTok Creative Center Hashtag Insights API

  • Go oder No-go bei einem Trend: Lesen Sie popularity_curve und die Zahlen in metrics, bevor Sie eine Kampagne auf einen Tag setzen, und prüfen Sie, ob die Kurve am letzten Tag noch steigt.
  • Märkte für die Expansion sichten: Nutzen Sie top_countries, um zu sehen, welche anderen Länder für einen Tag, der im Heimatmarkt im Trend liegt, am höchsten punkten, und nehmen Sie sie für lokalisierte Beiträge in die engere Wahl.

Profi-Tipps zur TikTok Creative Center Hashtag Insights API

  • Übergeben Sie dasselbe country und denselben time_range wie beim Ranking, aus dem die id stammt, damit die Zahlen die Liste beschreiben, aus der Sie den Tag gewählt haben.
  • Lesen Sie top_countries nicht als Ranking nach Menge: Der Wert ist relativ zur Größe des Landes, ein kleiner Markt kann daher über einem großen stehen.

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

Weitere Plattformen entdecken

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

TikTok Creative Center Hashtag Insights API — FAQ

TikTok Creative Center Hashtag Insights API ist eine Schnittstelle zum Abrufen des Insight-Datensatzes eines Trend-Hashtags auf TikTok, bestimmt durch seine Creative-Center-ID, Land und Zeitraum. Sie liefert Beitrags- und Aufrufzahlen, eine tägliche Beliebtheitskurve, Top-Länder nach Wert und Beispiel-Video-IDs.

Aus dem Feld id eines Ergebnisses von Trending Hashtags, entnommen aus dem Ranking des Landes, das Sie abfragen wollen. Es ist eine numerische Zeichenkette aus 5 bis 32 Ziffern, jedes andere Format wird mit einem 400-Fehler abgelehnt.

Hier nicht, denn dieser Endpunkt akzeptiert nur die numerische ID. Videozahl und Gesamtaufrufe eines Tags per Namen erhalten Sie mit TikTok Hashtag Views API.

top_countries und video_ids, die in Ranking-Zeilen null sind. rank ist hier null, weil ein Platz zum Ranking gehört; behalten Sie also den Platz aus dem Ergebnis von Trending Hashtags.

Er misst, wie beliebt der Hashtag in diesem Land im Verhältnis zur Größe des Landes ist, und die Liste ist vom höchsten Wert abwärts sortiert. Ein kleiner Markt kann deshalb einen großen übertreffen.

Die Aufgabe schlägt fehl und der Betrag wird vollständig erstattet. Eine erfolgreiche Anfrage wird einmal mit 0,5 Credits berechnet, egal wie viele video_ids zurückkommen.