tiktok-creative-center/
trending-hashtag-detail

Consultez un hashtag TikTok tendance par son ID Creative Center : nombres de publications et de vues, courbe de popularité quotidienne, pays principaux selon leur score et ID de vidéos d’exemple.

TikTok Creative Center Hashtag Insights API

ID de hashtag en entrée
Pays principaux
Vidéos d’exemple
0,5 crédit par requête
Prêt
README

Par SocQ · Mis à jour le

TikTok Creative Center Hashtag Insights

Une fiche Hashtag Insights du Creative Center présente un hashtag tendance sur un marché : ses nombres de publications et de vues, une courbe de popularité quotidienne, les pays où il est le plus populaire rapporté à leur taille, et des vidéos d’exemple qui l’utilisent. Ensemble, ces éléments montrent comment une tendance évolue, où elle trouve aussi un écho et quel type de contenu la porte.

Fonctionnalités de la TikTok Creative Center Hashtag Insights API

  • Un hashtag, recherché par IDhashtag_id prend l’id d’un résultat de Trending Hashtags et renvoie un enregistrement unique pour ce hashtag dans le pays et le time_range choisis.
  • Courbe et compteurs de la périodepopularity_curve donne une valeur datée par jour, de 0 à 100, avec metrics.posts_count et metrics.views_count à côté.
  • Pays classés par scoretop_countries liste country_code et score, du plus élevé au plus bas ; le score reflète la popularité rapportée à la taille du pays.
  • ID de vidéos d’exemplevideo_ids liste des vidéos qui utilisent le hashtag, pour voir sur quels contenus repose la tendance.

Paramètres de la TikTok Creative Center Hashtag Insights API

ParamètresObligatoireDescription
hashtag_idObligatoireID de hashtag issu d’un résultat de TikTok Creative Center Trending Hashtags.
countryFacultatifCode pays à deux lettres du marché, comme US, GB ou JP. US par défaut.
time_rangeFacultatifPériode à analyser : 7d (par défaut), 30d ou 90d.

Comment utiliser la TikTok Creative Center Hashtag Insights API

Prenez un ID de hashtag dans le classement des tendances et lisez sa fiche.

  1. Collectez des hashtags avec TikTok Creative Center Trending Hashtags et copiez un id.
  2. Envoyez {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} en POST à /v1/tiktok-creative-center/trending-hashtag-detail.
  3. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez l’enregistrement unique dans 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.

Cas d’usage de la TikTok Creative Center Hashtag Insights API

  • Décider d’y aller ou non sur une tendance : Lisez popularity_curve et les compteurs de metrics avant d’engager une campagne sur un hashtag, et vérifiez si la courbe monte encore le dernier jour.
  • Évaluer des marchés pour une expansion : Servez-vous de top_countries pour voir quels autres pays obtiennent le meilleur score pour un hashtag en tendance chez vous, et présélectionnez-les pour des publications localisées.

Conseils d’expert pour la TikTok Creative Center Hashtag Insights API

  • Transmettez les mêmes country et time_range que le classement d’où provient l’id, afin que les chiffres décrivent la liste dans laquelle vous avez choisi le hashtag.
  • Ne lisez pas top_countries comme un classement par volume : le score est rapporté à la taille du pays, si bien qu’un petit marché peut se placer au-dessus d’un grand.

En complément de la TikTok Creative Center Hashtag Insights API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok Creative Center.

Explorer d’autres plateformes

Combinez les données TikTok Creative Center avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Creative Center Hashtag Insights API — FAQ

TikTok Creative Center Hashtag Insights API est une interface programmatique pour récupérer la fiche d’un hashtag TikTok tendance, identifié par son ID Creative Center, son pays et sa période. Elle renvoie les nombres de publications et de vues, une courbe de popularité quotidienne, les pays principaux par score et des ID de vidéos d’exemple.

Dans le champ id d’un résultat de Trending Hashtags, pris dans le classement du pays que vous interrogerez. C’est une chaîne numérique de 5 à 32 chiffres, et tout autre format est rejeté avec une erreur 400.

Pas ici, car cet endpoint n’accepte que l’ID numérique. Pour obtenir le nombre de vidéos et le total de vues d’un hashtag par son nom, utilisez TikTok Hashtag Views API.

top_countries et video_ids, qui valent null dans les lignes du classement. rank vaut null ici parce qu’une position appartient au classement : conservez le rang du résultat de Trending Hashtags.

Il mesure la popularité du hashtag dans ce pays rapportée à la taille du pays, et la liste est triée du score le plus élevé au plus bas. Un petit marché peut donc devancer un grand.

La tâche échoue avec un remboursement intégral. Une requête réussie est facturée une seule fois, 0,5 crédit, quel que soit le nombre de video_ids renvoyés.