tiktok/
comment-replies

Collectez les réponses TikTok publiques à un commentaire à partir de l’URL d’une vidéo et de l’ID du commentaire, avec texte, auteurs, horodatages, engagement et contexte du parent sous forme d’enregistrements normalisés.

TikTok Comment Replies API

Réponses à un commentaire connu
Contexte de l’auteur
Référence au parent
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 Comment Replies

Les réponses aux commentaires TikTok sont des réactions publiques placées sous un commentaire de vidéo connu, avec le texte de la réponse, l’identité de l’auteur, les horodatages, les mentions J’aime et nombres de réponses visibles, ainsi qu’une référence au commentaire parent. Ces enregistrements de conversation servent à reconstituer une branche, à examiner les participants, à étudier les réactions et à suivre les réponses une à une.

Fonctionnalités de la TikTok Comment Replies API

  • Portée limitée à un commentaireAssociez l’URL d’une vidéo TikTok prise en charge à son comment_id connu pour collecter le flux public de réponses de ce commentaire, et non les commentaires de premier niveau de la vidéo.
  • Champs de réponse, d’auteur et d’engagementRecevez les ID et le texte des réponses, l’identité publique de l’auteur et les indicateurs de compte, les horodatages, les mentions J’aime et nombres de réponses visibles, les mentions et le contexte de la vidéo source.
  • Parcours borné et dédoublonnéSuit les curseurs de réponses disponibles, supprime les ID de commentaire en double et s’arrête à la limite demandée, à la fin du fil ou au plafond de collecte de 100 pages.

Paramètres de la TikTok Comment Replies API

ParamètresObligatoireDescription
urlObligatoireURL de vidéo TikTok obligatoire sur tiktok.com, www.tiktok.com ou m.tiktok.com, avec un chemin /video/{numeric_id}.
comment_idObligatoireID obligatoire et non vide du commentaire public de premier niveau sélectionné sur la même vidéo.
results_limitFacultatifNombre maximal de réponses demandées pour le commentaire ; vaut 100 par défaut et accepte les entiers de 20 à 2 000.

Comment utiliser la TikTok Comment Replies API

Partez de l’ID d’un commentaire de premier niveau d’une vidéo TikTok, envoyez une tâche de réponses asynchrone, puis lisez les enregistrements normalisés grâce à la pagination par curseur des résultats.

  1. Lancez TikTok Comments API sur la vidéo et retenez l’id du commentaire de premier niveau dont vous voulez les réponses.
  2. Envoyez en POST la même url de vidéo, ce comment_id et, si besoin, results_limit à /v1/tiktok/comment-replies.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut soit succeeded ou failed.
  4. Lisez data.results.items depuis /v1/tasks/{task_id}?limit=50 et transmettez results.next_cursor tant que results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/@loganpaul/video/7411198650782731563","comment_id":"7411205662439736097","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Cas d’usage de la TikTok Comment Replies API

  • Reconstitution de la branche d’un commentaire connu : Associez les ID de réponse, extra.parent_comment_id et extra.input_url pour reconstruire la branche de réponses publique située sous un commentaire de premier niveau choisi.
  • Examen des réponses une par une : Exploitez le texte des réponses, les horodatages, les mentions J’aime visibles et les nombres de réponses pour examiner et comparer les réactions publiques au sein d’une conversation ciblée.
  • Cartographie des participants à la conversation : Appuyez-vous sur les ID d’auteur publics, noms d’utilisateur, liens de profil, avatars et indicateurs de compte pour cartographier les participants présents dans le flux de réponses renvoyé.

Conseils d’expert pour la TikTok Comment Replies API

  • Prenez comment_id dans l’id normalisé d’un résultat de premier niveau de TikTok Comments et réutilisez l’URL de vidéo de ce résultat ; l’ID d’une vidéo n’est pas un ID de commentaire.
  • Validez l’hôte de l’URL et le chemin numérique /video/ avant l’envoi, afin que les liens raccourcis, de profil ou sans vidéo ne fassent pas échouer le contrôle d’entrée.
  • Réglez results_limit sur le volume de réponses voulu, sachant que le fil public peut se terminer avant la limite et que la collecte s’arrête après 100 pages de la source.
  • Lorsque vous combinez plusieurs tâches, dédoublonnez par id de réponse tout en gardant extra.parent_comment_id et extra.input_url, afin que chaque réponse reste rattachée à la bonne conversation.
  • Traitez le texte des réponses, les champs de l’auteur, les métriques, les mentions et les horodatages comme nullables, et échappez le texte généré par les utilisateurs avant de l’afficher dans vos outils en aval.

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

  • TikTok Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, indicateurs de compte et nombres d’audience.
  • TikTok Hashtags API — Collectez les vidéos publiques, créateurs, médias, sons et l’engagement pour des hashtags donnés.
  • 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 Comment Keywords API — Trouvez les mots-clés qui reviennent le plus dans les commentaires d’une vidéo, avec les commentaires correspondants.

Explorer d’autres plateformes

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

TikTok Comment Replies API — FAQ

TikTok Comment Replies API est une interface qui collecte les réponses publiques placées sous un commentaire de vidéo TikTok connu, à partir de l’URL de la vidéo et de l’ID du commentaire. Elle renvoie le texte normalisé des réponses, l’identité de l’auteur, les horodatages, l’engagement visible et le contexte du commentaire parent.

Lancez TikTok Comments API sur la même vidéo et utilisez l’id normalisé du commentaire de premier niveau choisi. Gardez cet id associé à l’URL de la vidéo source lorsque vous envoyez la tâche de réponses.

Utilisez une URL sur tiktok.com, www.tiktok.com ou m.tiktok.com dont le chemin contient /video/ suivi d’un ID de vidéo numérique. Un lien raccourci, une URL de profil ou une URL de vidéo sans comment_id non vide ne respecte pas la spécification de la requête.

Un enregistrement peut contenir l’ID et le texte de la réponse, l’URL de la vidéo source, l’identité publique de l’auteur et ses indicateurs de compte, les nombres de mentions J’aime et de réponses, les mentions, created_at, collected_at, extra.parent_comment_id et extra.input_url.

results_limit est un maximum, pas une garantie. La collecte peut s’achever lorsque le flux public de réponses se termine, que plus aucun nouvel ID de réponse unique n’est renvoyé, que le flux cesse de faire avancer son curseur ou que le plafond de 100 pages est atteint.

Chaque réponse normalisée enregistrée coûte 0,5 crédit, sans frais de base par tâche. L’estimation initiale utilise results_limit ou sa valeur par défaut de 100, tandis que l’utilisation finale suit les enregistrements réellement sauvegardés ; sans réponse enregistrée, aucun frais de résultat n’est facturé.