tiktok/
comment-replies

Obtenga las respuestas públicas de TikTok a un comentario a partir de la URL de un video y el ID del comentario, con texto, autores, marcas de tiempo, interacción y contexto del comentario principal en registros normalizados.

TikTok Comment Replies API

Respuestas a un comentario conocido
Contexto del autor
Referencia al comentario principal
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Comment Replies

Las respuestas a comentarios de TikTok son réplicas públicas debajo del comentario de un video conocido, con el texto de la respuesta, la identidad del autor, marcas de tiempo, los conteos visibles de Me gusta y de respuestas, y una referencia al comentario principal. Estos registros de conversación sirven para reconstruir ramas, revisar participantes, investigar reacciones y monitorear respuestas individuales.

Funcionalidades de la TikTok Comment Replies API

  • Alcance por comentarioCombine la URL de un video de TikTok compatible con su comment_id conocido para obtener las respuestas públicas de ese comentario, en lugar de los comentarios de primer nivel del video.
  • Campos de respuesta, autor e interacciónReciba los ID y el texto de las respuestas, la identidad pública del autor y los indicadores de cuenta, las marcas de tiempo, los conteos visibles de Me gusta y de respuestas, las menciones y el contexto del video de origen.
  • Recorrido acotado y sin duplicadosSigue los cursores de respuestas disponibles, elimina los ID de comentario duplicados y se detiene en el límite solicitado, al final del hilo o en el máximo de 100 páginas de recopilación.

Parámetros de la TikTok Comment Replies API

ParámetrosObligatorioDescripción
urlObligatorioURL obligatoria de un video de TikTok en tiktok.com, www.tiktok.com o m.tiktok.com con una ruta /video/{numeric_id}.
comment_idObligatorioID público obligatorio y no vacío del comentario de primer nivel seleccionado en el mismo video.
results_limitOpcionalMáximo de respuestas solicitadas para el comentario; el valor predeterminado es 100 y acepta enteros de 20 a 2,000.

Cómo usar la TikTok Comment Replies API

Comience con el ID de un comentario de primer nivel de un video de TikTok, envíe una tarea asíncrona de respuestas y lea los registros normalizados con paginación por cursor de resultados.

  1. Ejecute TikTok Comments API para el video y seleccione el id del comentario de primer nivel cuyas respuestas necesita.
  2. Envíe por POST la misma url del video, ese comment_id y, de forma opcional, results_limit a /v1/tiktok/comment-replies.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea data.results.items desde /v1/tasks/{task_id}?limit=50 y pase results.next_cursor mientras results.has_more sea 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.

Casos de uso de la TikTok Comment Replies API

  • Reconstrucción de la rama de un comentario conocido: Una los ID de respuesta, extra.parent_comment_id y extra.input_url para reconstruir la rama pública de respuestas bajo un comentario de primer nivel seleccionado.
  • Revisión de reacciones a nivel de respuesta: Use el texto de las respuestas, las marcas de tiempo, los Me gusta visibles y los conteos de respuestas para revisar y comparar las reacciones públicas dentro de una conversación concreta.
  • Mapa de participantes de la conversación: Use los ID públicos de autor, los nombres de usuario, los enlaces de perfil, los avatares y los indicadores de cuenta para mapear a los participantes presentes en las respuestas devueltas.

Consejos de expertos para la TikTok Comment Replies API

  • Tome comment_id del id normalizado de un resultado de TikTok Comments de primer nivel y reutilice la URL del video de ese resultado; el ID de un video no es el ID de un comentario.
  • Valide el host de la URL y la ruta numérica /video/ antes del envío, para que los enlaces acortados, de perfil o que no sean de video no fallen en la validación de entrada.
  • Ajuste results_limit al volumen de respuestas que necesita, teniendo en cuenta que el hilo público puede terminar antes del límite y que la recopilación se detiene tras 100 páginas de origen.
  • Al combinar tareas, deduplique por el id de la respuesta y conserve extra.parent_comment_id y extra.input_url para que cada respuesta siga asociada a la conversación correcta.
  • Trate el texto de las respuestas, los campos del autor, las métricas, las menciones y las marcas de tiempo como valores que pueden ser nulos, y escape el texto generado por los usuarios antes de mostrarlo en herramientas posteriores.

Además de la TikTok Comment Replies API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
  • TikTok Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
  • TikTok Comments API — Recolecta comentarios públicos de primer nivel, autores, interacción, menciones e indicadores de interacción del creador.
  • TikTok Videos API — Obtiene el creador, la descripción, el contenido multimedia, la música, las etiquetas, las menciones y la interacción desde URLs de videos.
  • TikTok Search API — Busca videos públicos por palabra clave con filtros de orden y de publicación compatibles.
  • TikTok Comment Keywords API — Encuentra las palabras clave más frecuentes en los comentarios de un video, con los comentarios que las respaldan.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Comment Replies API — FAQ

TikTok Comment Replies API es una interfaz que recopila las respuestas públicas debajo de un comentario conocido de un video de TikTok a partir de la URL del video y del ID del comentario. Devuelve texto de respuesta, identidad del autor, marcas de tiempo, interacción visible y contexto del comentario principal, todo normalizado.

Ejecute TikTok Comments API para el mismo video y use el id normalizado del comentario de primer nivel seleccionado. Mantenga ese id emparejado con la URL del video de origen al enviar la tarea de respuestas.

Use una URL en tiktok.com, www.tiktok.com o m.tiktok.com cuya ruta contenga /video/ seguido de un ID numérico de video. Un enlace acortado, una URL de perfil o la URL de un video sin un comment_id no vacío no cumplen con la especificación de la solicitud.

Un registro puede contener el ID y el texto de la respuesta, la URL del video de origen, la identidad pública del autor y sus indicadores de cuenta, los conteos de Me gusta y de respuestas, las menciones, created_at, collected_at, extra.parent_comment_id y extra.input_url.

results_limit es un máximo y no una garantía. La recopilación puede terminar cuando se acaban las respuestas públicas, cuando no se devuelven nuevos ID de respuesta únicos, cuando el cursor deja de avanzar o cuando se alcanza el máximo de 100 páginas.

Cada respuesta normalizada guardada cuesta 0.5 créditos, sin cargo base por tarea. La estimación inicial usa results_limit o su valor predeterminado de 100, mientras que el uso final depende de los registros realmente guardados; si no se guarda ninguna respuesta, no hay cargo por resultados.