YouTube Videos
Los videos de YouTube son subidas públicas con títulos, descripciones, contexto del canal, miniaturas, duración, datos de publicación, hashtags, clasificación de origen e interacción visible. Estas señales de metadatos y rendimiento sirven para enriquecer videos, investigar contenido, monitorear y hacer análisis comparativos.
Funcionalidades de la YouTube Videos API
- Consulta por lotes de URL conocidasConsulta varias URL conocidas de videos y Shorts públicos en una sola solicitud.
- Identidad de video estableDevuelve en cada resultado un ID de video estable, la URL canónica, el título, la descripción pública y el canal que lo publicó.
- Metadatos del contenidoIncluye miniaturas, duración, hashtags, fecha de publicación y tipo de contenido normalizado.
- Métricas de interacción de un momento concretoCaptura las vistas, los Me gusta y los comentarios públicos con collected_at para comparar un momento concreto.
- Esquema de video consistenteOfrece la misma estructura de video normalizada para videos regulares y URL de Shorts compatibles.
Parámetros de la YouTube Videos API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL públicas de videos o Shorts de YouTube, separadas por comas o saltos de línea. |
Cómo usar la YouTube Videos API
Convierta una bandeja de enlaces en registros que su aplicación pueda combinar, buscar y actualizar. La solicitud es asíncrona, así que conserve el ID de tarea hasta que se haya resuelto cada URL accesible.
- Reúna y deduplique las URL públicas de reproducción o de Shorts; las URL de canales y de resultados de búsqueda corresponden a otros endpoints.
- Envíe la lista urls por POST a /v1/youtube/videos y almacene el task_id devuelto junto a su lote de origen.
- Consulte /v1/tasks/{task_id}; queued y running indican que el lote aún se está procesando.
- Tras el éxito, indexe data.results.items por id y continúe con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"]}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casos de uso de la YouTube Videos API
- Enriquecimiento de listas de URL: Agregue títulos, información del canal, miniaturas, duración, fechas de publicación y métricas públicas a una lista existente de URL de YouTube.
- Comparación de videos seleccionados: Compare las vistas, los Me gusta, los comentarios, la duración y los datos de publicación entre un conjunto elegido de videos o Shorts.
- Monitoreo de campañas y competidores: Recopile instantáneas repetidas de metadatos de videos conocidos de campañas, creadores o competidores.
- Catálogos de contenido: Proporcione registros de video normalizados a flujos internos de búsqueda, informes, moderación, resumen o analítica.
Consejos de expertos para la YouTube Videos API
- Use id como clave primaria. Los títulos pueden cambiar y un mismo video puede llegar con varios formatos de URL válidos.
- Conserve canonical_url para los enlaces salientes, pero guarde input_url cuando necesite rastrear de dónde provino un registro.
- Las métricas describen la página en collected_at. Comparar dos instantáneas es útil; sobrescribir la anterior elimina ese historial.
- Trate los enlaces de la descripción como entradas externas no confiables antes de mostrarlos, rastrearlos o importarlos.
- Que falte un resultado no prueba que una URL nunca haya existido. Los elementos privados, eliminados, restringidos o temporalmente inaccesibles pueden desaparecer de un lote.
- Los comentarios y el texto de las transcripciones son independientes a propósito. Solicítelos solo para los elementos que lleguen a esas etapas de su flujo de trabajo.
- Para descubrir por tema, comience con Search. Use Videos cuando ya sepa qué URL le importa.
APIs relacionadas
Además de la YouTube Videos 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 Shorts API — Recolecta Shorts públicos por canal, con miniaturas, duración, datos de publicación e interacción.
- YouTube Related Videos API — Enumera los videos recomendados junto a la URL de un video, con títulos, canales, vistas y miniaturas.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API