tiktok-creative-center/
trending-hashtags

Obtenez le classement des hashtags tendance d’un pays sur le TikTok Creative Center, avec nombres de publications et de vues et une courbe de popularité quotidienne sur 7, 30 ou 90 jours.

TikTok Creative Center Trending Hashtags API

Classements par pays
7, 30 ou 90 jours
Courbe de popularité quotidienne
0,5 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

TikTok Creative Center Trending Hashtags

Les hashtags tendance du Creative Center classent les hashtags qui gagnent le plus d’attention dans un pays sur les 7, 30 ou 90 derniers jours, en donnant à chacun sa position, son nombre de publications, ses vues et une courbe de popularité jour par jour. Ce classement montre quels sujets décollent sur un marché, à quelle vitesse chaque hashtag a progressé et quelles tendances valent la peine d’être rejointes tant qu’elles montent.

Fonctionnalités de la TikTok Creative Center Trending Hashtags API

  • Un classement par payscountry accepte un code à deux lettres comme US, GB ou JP, et chaque marché renvoie son propre ordre de classement.
  • Listes sur 7, 30 et 90 jourstime_range choisit la période sur laquelle le classement est construit, et chaque période donne sa propre liste.
  • Nombres de publications et de vuesmetrics.posts_count et metrics.views_count donnent le volume que Creative Center indique pour chaque hashtag.
  • Courbe de popularité quotidiennepopularity_curve renvoie une valeur datée par jour sur une échelle de 0 à 100 : la trajectoire d’un hashtag arrive avec sa ligne de classement.
  • Nom, lien et ID du hashtagChaque ligne contient name sans le #, une url tiktok.com/tag et l’id que Hashtag Insights prend comme hashtag_id.

Paramètres de la TikTok Creative Center Trending Hashtags API

ParamètresObligatoireDescription
countryFacultatifCode pays à deux lettres du marché, comme US, GB ou JP. US par défaut.
time_rangeFacultatifPériode couverte par le classement : 7d (par défaut), 30d ou 90d.
results_limitFacultatifNombre de hashtags à renvoyer, de 1 à 100. 20 par défaut.

Comment utiliser la TikTok Creative Center Trending Hashtags API

Choisissez un pays et une période, puis lisez le classement.

  1. Envoyez {"country": "US", "time_range": "7d", "results_limit": 20} en POST à /v1/tiktok-creative-center/trending-hashtags.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les hashtags dans results.items, dans l’ordre du classement, et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","time_range":"7d","results_limit":20}'

# Each item has rank, metrics and a dated popularity_curve.

Cas d’usage de la TikTok Creative Center Trending Hashtags API

  • Suivre chaque jour les nouveaux entrants : Conservez la liste de chaque jour avec son collected_at et comparez les id au relevé précédent pour voir quels hashtags sont entrés dans le classement d’un pays ou en sont sortis.
  • Présélections de hashtags par marché : Demandez le même time_range pour chaque pays cible et placez les listes côte à côte pour choisir les hashtags de chaque campagne localisée.
  • Pic éphémère ou tenue dans la durée : Comparez les listes 7d et 90d d’un même pays : les hashtags présents seulement dans la liste courte sont des pics d’une semaine, ceux qui se classent haut dans les deux retiennent l’attention depuis des mois.

Conseils d’expert pour la TikTok Creative Center Trending Hashtags API

  • Enregistrez chaque relevé avec son country, son time_range et son collected_at, car un rang n’a de sens qu’au sein de la liste dont il provient.
  • Gardez les mêmes country et time_range quand vous transmettez un id à Hashtag Insights.
  • Récupérez une fois les 100 hashtags complets et filtrez-les en local plutôt que de répéter des requêtes avec d’autres valeurs de results_limit, car chaque requête est facturée sur les lignes renvoyées.

En complément de la TikTok Creative Center Trending Hashtags 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 Trending Hashtags API — FAQ

TikTok Creative Center Trending Hashtags API est une interface programmatique pour récupérer les hashtags classés comme tendance dans un pays sur le TikTok Creative Center, sur 7, 30 ou 90 jours. Elle renvoie pour chaque hashtag le rang, les nombres de publications et de vues et une courbe de popularité quotidienne.

Envoyez country sous forme de code à deux lettres comme US, GB ou JP ; la valeur par défaut est US, et chaque marché a son propre classement. Un marché sans classement publié renvoie zéro résultat et n’est pas facturé.

Prenez 7d pour ce qui monte en ce moment et 90d pour les hashtags qui retiennent l’attention depuis des mois. Chaque période est une liste distincte : un même hashtag peut donc se classer différemment dans chacune.

Jusqu’à 100 par pays et par période, réglés avec results_limit (20 par défaut). La facturation suit les lignes renvoyées, à 0,5 crédit chacune : une liste complète de 100 hashtags coûte donc 50 crédits.

Lisez la fin de sa popularity_curve, dont les valeurs vont de 0 à 100, une par jour. Une série qui monte encore le dernier jour est en progression, et une série retombée après un sommet antérieur se refroidit, quel que soit le rang du hashtag.

Non ; la requête n’accepte que country, time_range et results_limit. Pour repérer les nouveaux entrants, conservez la liste de chaque jour et comparez les id des hashtags avec celle de la veille.

TikTok ne publie aucun calendrier d’actualisation. La courbe de popularité avance par pas quotidiens et chaque enregistrement porte collected_at : une requête par pays et par jour suffit donc pour la suivre.

Non. Une clé API SocQ est le seul identifiant nécessaire.