tiktok/
hashtag-detail

Vérifiez combien de vidéos et combien de vues cumulées comptent jusqu’à 20 hashtags TikTok en une seule requête, avec l’ID et le lien de la page de chaque hashtag pour les comparer côte à côte.

TikTok Hashtag Views API

Jusqu’à 20 hashtags
Vues cumulées
Nombre de vidéos
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

TikTok Hashtag Views

La page d’un hashtag TikTok rassemble toutes les vidéos publiques qui l’utilisent en deux totaux cumulés : le nombre de vidéos qui le portent et le nombre de vues qu’elles ont générées. Lus ensemble, ils indiquent l’ampleur et la saturation d’un sujet, et le rapport entre vues et vidéos donne une idée de la performance habituelle des contenus publiés sous ce hashtag.

Fonctionnalités de la TikTok Hashtag Views API

  • Jusqu’à 20 hashtags par requêteEnvoyez de 1 à 20 noms, avec ou sans #, et recevez un enregistrement pour chaque hashtag existant.
  • Des totaux sous forme d’entiersmetrics.posts_count et metrics.views_count reviennent sous forme d’entiers simples plutôt que de chaînes abrégées : ils se trient et se divisent directement.
  • ID du hashtag et lien de sa pageid contient l’ID numérique du hashtag chez TikTok et url sa page, ce qui donne à chaque enregistrement une clé de jointure d’une exécution à l’autre.

Paramètres de la TikTok Hashtag Views API

ParamètresObligatoireDescription
hashtagsObligatoireDe 1 à 20 noms de hashtags, avec ou sans le préfixe #.

Comment utiliser la TikTok Hashtag Views API

Envoyez une liste de hashtags et lisez un enregistrement par hashtag.

  1. Envoyez {"hashtags": ["cooking", "booktok"]} en POST à /v1/tiktok/hashtag-detail.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez name, metrics.posts_count et metrics.views_count de chaque hashtag dans results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["cooking","booktok"]}'

# metrics.posts_count is the video count; metrics.views_count is the total views.

Cas d’usage de la TikTok Hashtag Views API

  • Présélectionner des hashtags de campagne : Placez les hashtags candidats dans une même requête et comparez posts_count pour la saturation et views_count pour la portée avant d’arrêter votre sélection.
  • Suivi d’un hashtag de marque : Interrogez le hashtag de votre campagne à intervalles réguliers et tracez la progression de son nombre de vidéos et de ses vues cumulées après chaque temps fort.
  • Mesurer la taille d’un sujet : Cherchez les hashtags qui définissent une niche, une tendance ou un sujet de société et comparez leurs totaux pour voir où se concentre le contenu sur ce thème.

Conseils d’expert pour la TikTok Hashtag Views API

  • N’additionnez pas les views_count de plusieurs hashtags pour mesurer un sujet : une vidéo qui en porte plusieurs est comptée sous chacun. Comparez-les côte à côte ou retenez le plus grand.
  • Ne divisez views_count par posts_count que si posts_count est présent et supérieur à zéro, puis classez les hashtags par vues moyennes par vidéo pour comparer des tailles très différentes.
  • Enregistrez chaque résultat avec son horodatage collected_at quand vous suivez un hashtag : chaque requête renvoie les totaux du moment, et la croissance n’apparaît que si vous conservez les instantanés précédents.
  • Rapprochez les résultats de votre liste par name ou par id, jamais par position : un hashtag inexistant est ignoré, et la sortie peut donc être plus courte que l’entrée.

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

  • TikTok Hashtags API — Collectez les vidéos publiques, créateurs, médias, sons et l’engagement pour des hashtags donnés.
  • TikTok Search API — Recherchez des vidéos publiques par mot-clé avec tris et filtres de publication pris en charge.
  • TikTok Live Room Info API — Consultez un live connu à partir de la paire d’ID de salle et de propriétaire, et obtenez le statut, le contexte du propriétaire, le média de couverture et les nombres d’audience.
  • TikTok Search Users API — Recherchez des comptes TikTok publics par mot-clé.
  • TikTok Top Search API — Recherchez par mot-clé des vidéos et des publications d’images, avec légendes, créateurs et nombres d’interactions.
  • TikTok Trending Searches API — Obtenez les recherches tendance du jour sur TikTok, classées par rang.

Explorer d’autres plateformes

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

TikTok Hashtag Views API — FAQ

TikTok Hashtag Views API est une interface programmatique pour consulter, par nom, les totaux de jusqu’à 20 hashtags TikTok. Elle renvoie pour chaque hashtag son ID, l’URL de sa page, son nombre de vidéos et ses vues cumulées.

Envoyez le nom du hashtag et lisez metrics.views_count pour les vues cumulées et metrics.posts_count pour le nombre de vidéos qui l’utilisent. Ce sont deux chiffres cumulés pour l’ensemble du hashtag.

La réponse contient metrics.views_count à côté de metrics.posts_count pour chaque hashtag, et un compteur que TikTok ne communique pas pour un hashtag est renvoyé à null.

Jusqu’à 20, écrits avec ou sans #. Chaque hashtag existant renvoie son propre enregistrement : toute une présélection se compare donc à partir d’un seul résultat.

Il est exclu des résultats et n’est pas facturé, tandis que les autres hashtags de la requête sont renvoyés normalement. Une requête dont aucun hashtag n’existe ne coûte rien.

L’endpoint renvoie les totaux actuels avec un horodatage collected_at, sans historique. Lancez-le à intervalles réguliers et conservez chaque instantané pour tracer la croissance.

Non, uniquement les totaux et les identifiants du hashtag. Pour collecter les vidéos elles-mêmes, utilisez TikTok Hashtags.

Par hashtag existant, à raison de 0,5 crédit chacun. Une liste de 20 hashtags existants coûte donc 10 crédits, et une requête sans correspondance ne coûte rien.