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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL pública y estable, obligatoria, del video de YouTube que contiene el comentario principal. |
comment_id | Obligatorio | ID obligatorio del comentario de nivel superior que pertenece a la URL de video enviada. |
results_limit | Opcional | Cantidad 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.
- Elija la URL de un video público de YouTube y el ID de un comentario de nivel superior devuelto para ese video.
- Envíe url, comment_id y results_limit por POST a /v1/youtube/comment-replies.
- Conserve el task_id devuelto y consulte GET /v1/tasks/{task_id} mientras la tarea esté en estado queued, running o retrying.
- 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 trueCasos 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.
APIs relacionadas
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.
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API