YouTube Comments
Los comentarios de YouTube son las respuestas públicas de los espectadores a los videos, con texto, contexto del autor, hora de publicación, Me gusta visibles, cantidad de respuestas, datos del video de origen y relaciones de la conversación. Estas señales de debate sirven para analizar opiniones, investigar audiencias, revisar temas y monitorear respuestas.
Funcionalidades de la YouTube Comments API
- Recopilación de comentarios de varios videosRecopila los comentarios públicos de varias URL de videos en una sola solicitud.
- Límites y orden por videoPermite definir un results_limit por video y elegir el orden por más recientes o por relevancia.
- Campos de comentario y autorDevuelve el ID del comentario, el texto, los datos públicos del autor, la hora de publicación y la información del video de origen.
- Relaciones entre hilosIncluye el número público de Me gusta, la cantidad de respuestas y el ID del comentario principal para un análisis estructurado del debate.
- Indicadores de interacción del creadorConserva los indicadores de propietario del canal y de corazón del creador cuando aparecen en el resultado público.
Parámetros de la YouTube Comments API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL públicas de videos de YouTube con comentarios visibles, separadas por comas o saltos de línea. |
results_limit | Opcional | Cantidad máxima de registros elegibles que se solicitan por cada URL de entrada. Debe ser un entero positivo y su valor predeterminado es 100. |
sort_by | Opcional | Orden de los comentarios. El valor predeterminado es newest; relevance usa el orden público de relevancia de YouTube. |
Cómo usar la YouTube Comments API
Decida si importan más la actualidad o la relevancia, defina un presupuesto de muestreo por video y mantenga intactas las relaciones devueltas cuando los comentarios entren en su pipeline de análisis.
- Elija las URL de videos públicos y defina si necesita reacciones recientes o el debate ordenado por YouTube.
- Envíe urls, results_limit y sort_by por POST a /v1/youtube/comments; el límite se aplica a cada video.
- Consulte /v1/tasks/{task_id}; en el mismo lote se resuelven tanto los videos con comentarios habilitados como las secciones de comentarios no disponibles.
- Tras el éxito, deduplique por ID de comentario, relacione las respuestas con parent_comment_id y pagine mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casos de uso de la YouTube Comments API
- Análisis de opiniones de la audiencia: Analice el texto de los comentarios públicos para identificar el sentimiento, las preguntas recurrentes, los temas y las ideas de contenido.
- Monitoreo de campañas y eventos: Siga las reacciones públicas a creadores, lanzamientos de productos, campañas, anuncios o eventos.
- Investigación de debates: Use los Me gusta, la cantidad de respuestas y las referencias al comentario principal para estudiar los comentarios con mucha interacción y los hilos activos.
- Conjuntos de datos para análisis de texto: Proporcione comentarios normalizados a flujos de clasificación, agrupación, resumen, asistencia a la moderación o alertas.
Consejos de expertos para la YouTube Comments API
- Elija sort_by antes del análisis. Pasar de relevance a newest cambia la muestra, por lo que las dos exportaciones no deben compararse como si solo hubiera cambiado el orden.
- Trate results_limit como un tope por video. Los comentarios desactivados, la moderación, el orden, las restricciones y la poca actividad pueden reducir la cantidad devuelta.
- Use el ID del comentario para deduplicar y parent_comment_id para vincular, pero no suponga que todas las respuestas visibles están en la misma página de resultados.
- Los totales de Me gusta y de respuestas son observaciones del momento de la recopilación, no medidas fijas de sentimiento ni de importancia.
- El texto de los comentarios y los campos del autor son entradas públicas no confiables. Escápelos en las interfaces y valide las URL incrustadas antes de usarlas.
- Una coincidencia de palabra clave no es un análisis de sentimiento. Conserve el texto original y el contexto de origen al aplicar etiquetas o resúmenes.
- Conserve el ID del video y collected_at en cada fila para que los analistas puedan reproducir qué muestra de conversación revisaron.
APIs relacionadas
Además de la YouTube Comments 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 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 Comment Replies API — Continúa un hilo de comentarios conocido de YouTube a partir de su token de respuestas y devuelve las respuestas públicas, los autores, la interacción y el contexto del comentario principal.
- 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