youtube/
videos

Obtenga los metadatos públicos de URL conocidas de videos o Shorts de YouTube, con títulos normalizados, contexto del canal, miniaturas, duración e interacción visible.

YouTube Videos API

Detalles del video
URL conocidas
Métricas públicas
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 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ámetrosObligatorioDescripción
urlsObligatorioURL 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.

  1. 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.
  2. Envíe la lista urls por POST a /v1/youtube/videos y almacene el task_id devuelto junto a su lote de origen.
  3. Consulte /v1/tasks/{task_id}; queued y running indican que el lote aún se está procesando.
  4. 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=50

Casos 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.

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.

Explorar otras plataformas

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

YouTube Videos API — FAQ

YouTube Videos API obtiene los metadatos públicos de URL conocidas de videos o Shorts de YouTube. Devuelve identidad normalizada, títulos, descripciones, información del canal, miniaturas, duración, fechas de publicación, métricas de interacción y hora de recopilación.

Envíe una o más URL públicas de videos o Shorts de YouTube en la lista urls.

Sí. Las URL públicas de Shorts son compatibles y usan la misma estructura de video normalizada, con su tipo de contenido conservado.

No. Las métricas son valores públicos observados en el momento de la recopilación. Almacene collected_at y recopile de nuevo las mismas URL cuando necesite comparaciones históricas.

El resultado del video incluye el número público de comentarios, no el texto de los comentarios ni el de las transcripciones. Use Comments para los registros de comentarios y Transcripts para los subtítulos disponibles.

El uso cuesta 0.5 créditos por cada resultado de video normalizado devuelto.