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ètres | Obligatoire | Description |
|---|---|---|
hashtag_id | Obligatoire | ID de hashtag issu d’un résultat de TikTok Creative Center Trending Hashtags. |
country | Facultatif | Code pays à deux lettres du marché, comme US, GB ou JP. US par défaut. |
time_range | Facultatif | Pé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.
- Collectez des hashtags avec TikTok Creative Center Trending Hashtags et copiez un id.
- Envoyez {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} en POST à /v1/tiktok-creative-center/trending-hashtag-detail.
- 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.
API associées
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.
- TikTok Creative Center Top Ads API — Parcourez les publicités les plus performantes par mot-clé et par période, avec légendes, CTR, mentions « J’aime » et vidéo publicitaire.
- TikTok Creative Center Ad Analysis API — Analysez seconde par seconde une publicité du classement, avec ses courbes de taux de clics et de rétention.
- TikTok Creative Center Trending Hashtags API — Obtenez le classement des hashtags tendance d’un pays, avec nombres de publications, vues et courbes de popularité.
- TikTok Creative Center Top Videos API — Obtenez le classement des vidéos les plus performantes d’un pays, avec vues et taux d’engagement.
- TikTok Creator Marketplace API — Obtenez des fiches Creator Marketplace avec données démographiques des abonnés, vues médianes et tarifs de départ.