tiktok/
hashtags

Collectez les vidéos TikTok publiques d’un ou plusieurs hashtags, avec contexte normalisé du créateur, de la légende, des médias, du son, de l’engagement et du hashtag correspondant.

TikTok Hashtags API

Suivi de campagnes
Contenus de communauté
Comparaison de hashtags
0,7 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 Hashtags

Les hashtags TikTok sont des libellés thématiques qui relient des vidéos publiques autour d’une expression, d’une campagne, d’un événement ou d’un centre d’intérêt, avec des signaux de créateur, de contenu, de médias, de son et d’engagement. Ces enregistrements servent à repérer les tendances, à surveiller des sujets, à étudier des campagnes et à analyser l’audience.

Fonctionnalités de la TikTok Hashtags API

  • Collecte de hashtags en parallèleEnvoyez en parallèle plusieurs hashtags de campagne, de marque ou de communauté.
  • Hashtags normalisés en entréeRamène #campaign et campaign à un même format de hashtag.
  • Limite de résultats par hashtagAppliquez results_limit à chaque hashtag pour planifier clairement l’échantillon.
  • Contexte du hashtag correspondantConservez le groupe envoyé grâce à matched_hashtag sur chaque vidéo.
  • Enregistrements de vidéos comparablesComparez les vues des hashtags, les créateurs, les éléments créatifs et l’engagement des vidéos dans une structure de données unique.

Paramètres de la TikTok Hashtags API

ParamètresObligatoireDescription
hashtagsObligatoireListe obligatoire de valeurs de hashtag explicites, avec un # initial facultatif.
results_limitFacultatifLimite positive de vidéos demandées par hashtag. Vaut 100 par défaut.

Comment utiliser la TikTok Hashtags API

Listez les hashtags à suivre, fixez la taille de l’échantillon de vidéos pour chacun et constituez un jeu de données prêt pour la comparaison entre groupes.

  1. Réunissez les hashtags de campagne, de marque ou de communauté, normalisez les espaces et le #, puis dédoublonnez-les.
  2. Envoyez hashtags et results_limit en POST à /v1/tiktok/hashtags et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items, puis enchaînez avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["space","#astronomy"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la TikTok Hashtags API

  • Suivi de campagnes UGC : Collectez la participation sous les hashtags officiels d’une campagne et examinez la portée des créateurs, l’orientation des contenus et la répartition de l’engagement.
  • Inventaires de contenus par hashtag de marque : Transformez les vidéos des hashtags de marque et de produit en bibliothèque consultable pour les équipes marketing et réseaux sociaux.
  • Profils de communautés d’intérêt : Appuyez-vous sur les créateurs, légendes, musiques et l’engagement pour comprendre la culture de contenu autour d’un hashtag d’intérêt.
  • Comparaison de cohortes de hashtags : Collectez plusieurs hashtags en parallèle et comparez la répartition des créateurs, les éléments créatifs et les performances d’un groupe à l’autre.

Conseils d’expert pour la TikTok Hashtags API

  • Retirez le # initial, normalisez la casse et dédoublonnez les valeurs pour que chaque hashtag forme un groupe d’échantillon bien défini.
  • Utilisez le nombre de hashtags multiplié par results_limit comme maximum demandé, et non comme total de résultats garanti.
  • Conservez matched_hashtag afin que les vidéos collectées via plusieurs groupes gardent une provenance complète.
  • Appliquez le même results_limit et un calendrier de collecte identique lorsque vous comparez des cohortes de hashtags.
  • Traitez le nombre de vues du hashtag et les métriques d’engagement de chaque vidéo comme des valeurs distinctes, relevées à un instant donné.
  • Enrichissez les créateurs fréquents avec les données de Profiles pour comprendre la répartition des créateurs qu’attire chaque hashtag.

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

  • TikTok Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
  • TikTok Videos API — Récupérez le créateur, la légende, les médias, la musique, les tags, les mentions et l’engagement à partir d’URL de vidéos.
  • 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 Hashtag Views API — Consultez en une seule fois le nombre total de vidéos et de vues de 20 hashtags au maximum.

Explorer d’autres plateformes

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

TikTok Hashtags API — FAQ

TikTok Hashtags API collecte les vidéos accessibles publiquement pour un ou plusieurs hashtags TikTok précisés. Elle renvoie des données normalisées sur la vidéo, le créateur, la légende, les médias, le son, l’engagement et le hashtag correspondant.

Placez les noms de hashtags dans le tableau hashtags. Les formats fyp et #fyp sont tous deux acceptés, et le # initial est normalisé avant la collecte.

Oui. hashtags accepte plusieurs noms, collectés séparément dans la même tâche asynchrone.

results_limit s’applique séparément à chaque hashtag envoyé et vaut 100 par défaut. Trois hashtags avec une valeur de 100 demandent jusqu’à 100 vidéos pour chacun.

matched_hashtag enregistre le hashtag envoyé qui a produit la vidéo ; associé au nombre de vues public du hashtag, il permet l’attribution et l’analyse par groupe.

Les résultats comprennent l’ID de la vidéo, l’URL, la légende, l’heure de publication, le créateur, l’engagement public, les hashtags, les mentions, les médias, la musique et l’heure de collecte.

Regroupez les résultats par matched_hashtag, puis comparez la répartition des créateurs, les légendes, la musique, les vues des hashtags et l’engagement des vidéos d’un groupe à l’autre.

Chaque vidéo de hashtag normalisée renvoyée coûte 0,7 crédit.