youtube/
comment-replies

Recopile las respuestas públicas de YouTube a partir de una URL de video estable y el ID del comentario principal, con texto, autores, interacción, marcas de tiempo y contexto del hilo.

YouTube Comment Replies API

Entrada de comentario estable
Respuestas públicas
Contexto del hilo
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

YouTube Comment Replies

Las respuestas a comentarios de YouTube son respuestas públicas anidadas bajo un comentario de nivel superior de un video, con el texto de la respuesta, la identidad del autor, los Me gusta visibles, la hora de publicación y el contexto del comentario principal o del video. Estos registros de hilos sirven para reconstruir conversaciones, revisar respuestas y preparar conjuntos de datos de debate público.

Funcionalidades de la YouTube Comment Replies API

  • Referencia de comentario estableParte de una URL pública de video y del ID de su comentario principal, mientras SocQ resuelve internamente el token de continuación vigente de las respuestas.
  • Registros de respuestas y autoresDevuelve los IDs de las respuestas, el texto público, las URL asociadas, las horas de publicación y la identidad normalizada del autor o del canal.
  • Contexto del hilo y del creadorMantiene juntos los Me gusta visibles, la cantidad de respuestas anidadas, las referencias al comentario principal y al video, y los marcadores de propietario del canal o de corazón del creador.
  • Recopilación acotada por continuaciónSigue los tokens de continuación posteriores del origen, elimina los IDs de respuesta duplicados y se detiene en el límite elegido, al agotarse el hilo o en el tope de 100 páginas.

Parámetros de la YouTube Comment Replies API

ParámetrosObligatorioDescripción
urlObligatorioURL pública y estable, obligatoria, del video de YouTube que contiene el comentario principal.
comment_idObligatorioID obligatorio del comentario de nivel superior que pertenece a la URL de video enviada.
results_limitOpcionalCantidad máxima de respuestas públicas que se recopilan de este hilo. El ejemplo documentado usa 20 y el rango aceptado va de 20 a 2000.

Cómo usar la YouTube Comment Replies API

Envíe una URL de video estable y el ID del comentario principal como una tarea asíncrona y lea los registros de respuestas normalizados de la tarea completada.

  1. Elija la URL de un video público de YouTube y el ID de un comentario de nivel superior devuelto para ese video.
  2. Envíe url, comment_id y results_limit por POST a /v1/youtube/comment-replies.
  3. Conserve el task_id devuelto y consulte GET /v1/tasks/{task_id} mientras la tarea esté en estado queued, running o retrying.
  4. Tras el éxito, lea data.results.items y pase data.results.next_cursor como cursor en la solicitud de la tarea mientras data.results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

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

Casos de uso de la YouTube Comment Replies API

  • Reconstrucción de hilos conocidos: Use los IDs de respuesta, parent_comment_id, video_id, las URL y las marcas de tiempo para volver a vincular las respuestas guardadas con un comentario de nivel superior seleccionado.
  • Revisión de la audiencia a nivel de respuesta: Compare el texto de las respuestas públicas, la identidad del autor, los Me gusta visibles, la cantidad de respuestas anidadas y los marcadores de interacción del creador dentro de un mismo hilo conocido.
  • Preparación de conjuntos de datos de debate público: Combine el texto de las respuestas normalizadas, los autores, las marcas de tiempo y el contexto del hilo en registros para revisión manual o procesamiento de texto posterior.

Consejos de expertos para la YouTube Comment Replies API

  • Mantenga emparejados la URL del video y el ID del comentario de nivel superior para que el hilo de respuestas y el video de origen permanezcan alineados.
  • SocQ resuelve internamente el token de continuación vigente; si un token del origen vence, reintente con la misma referencia estable.
  • Mantenga el ID del comentario de origen separado del cursor que devuelve GET /v1/tasks/{task_id}; el primero selecciona un hilo de respuestas de YouTube, mientras que el segundo pagina los resultados guardados de la tarea.
  • Defina results_limit según el tamaño esperado del hilo, pero trátelo como un tope, porque la visibilidad pública y el agotamiento del hilo pueden reducir la cantidad devuelta.
  • Deduplique los registros guardados por ID de respuesta y conserve parent_comment_id, video_id y extra.reply_token al vincular las respuestas con su comentario de origen.
  • Admita valores nulos en los campos de autor, marca de tiempo, métricas y marcadores del creador, y escape el texto público de las respuestas antes de mostrarlo en otra interfaz.

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

  • YouTube Channel Videos API — Recolecta videos públicos regulares desde URLs de canales, sin incluir Shorts ni transmisiones en vivo.
  • YouTube Comments API — Recolecta comentarios públicos, autores, interacción, videos de origen y contexto de la conversación.
  • YouTube Transcripts API — Obtiene las transcripciones disponibles en texto plano, con selección de idioma opcional.
  • YouTube Channels API — Obtiene la identidad del canal público, imágenes, verificación y estadísticas visibles de audiencia.
  • YouTube Videos API — Obtiene metadatos, miniaturas, duración e interacción desde URLs conocidas de videos o Shorts.
  • YouTube Community Post Comments API — Recolecta los comentarios del enlace de una publicación de la comunidad, con los canales de quienes comentan y los conteos de Me gusta y de respuestas.

Explorar otras plataformas

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

YouTube Comment Replies API — FAQ

YouTube Comment Replies API es una interfaz programática que recopila las respuestas públicas a un comentario de nivel superior de YouTube. Envíe la URL de video estable y el ID del comentario para recibir el texto de las respuestas, la identidad del autor, la interacción visible, las marcas de tiempo y el contexto del hilo.

Ejecute YouTube Comments API con la URL de un video público y use el ID de un comentario de nivel superior compatible devuelto para ese mismo video.

No. SocQ resuelve el token de continuación vigente a partir de la URL del video y el ID del comentario enviados; la entrada heredada del token sigue disponible como vía de compatibilidad de la API, pero este playground no la usa.

results_limit acepta enteros de 20 a 2000, y el ejemplo documentado del playground envía 20. La recopilación se detiene en ese tope, cuando termina el hilo público o tras 100 páginas del origen.

Una respuesta puede incluir su ID, URL, texto, datos públicos del autor o del canal, Me gusta visibles y cantidad de respuestas anidadas, horas de publicación y de recopilación, además del contexto de video, comentario principal, marcadores del creador y token en extra.

No. comment_id selecciona el hilo de respuestas de YouTube de origen, mientras que cursor pagina los registros normalizados ya guardados en una tarea de SocQ exitosa.

Puede ser que el comentario principal no exponga un token de respuestas, que el hilo termine antes de results_limit, o que las respuestas estén eliminadas, ocultas, retenidas para revisión, sean solo para miembros, estén desactivadas o no estén disponibles para el público.

Cada respuesta normalizada guardada cuesta 0.5 créditos. La facturación sigue la cantidad real de registros guardados, así que un resultado vacío no genera cargo por unidad de resultado.