youtube/
channel-videos

Recopile los videos públicos regulares de URL de canales de YouTube, con títulos normalizados, miniaturas, duración, datos de publicación, contexto del canal y métricas de interacción.

YouTube Channel Videos API

Videos del canal
Videos regulares
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 Channel Videos

Los videos de un canal de YouTube son las subidas regulares de un canal concreto, con títulos, descripciones, miniaturas, duración, datos de publicación e interacción visible. Estos registros sirven para catalogar canales, analizar la publicación de contenido, monitorear contenido y elaborar informes históricos.

Funcionalidades de la YouTube Channel Videos API

  • Recopilación de videos de varios canalesRecopila los videos públicos regulares de varias URL de canales en una sola solicitud.
  • Límites de resultados por canalPermite definir un results_limit distinto para cada canal de entrada, con un valor predeterminado de 100.
  • Metadatos de video normalizadosDevuelve la identidad del video normalizada, los metadatos del contenido, las miniaturas, la duración, la fecha de publicación y el canal que lo publicó.
  • Métricas de interacción de un momento concretoIncluye las vistas, los Me gusta y los comentarios públicos con collected_at para compararlos más adelante.
  • Alcance de videos regularesExcluye los Shorts y las transmisiones en vivo para que el resultado se centre en los videos regulares del canal.

Parámetros de la YouTube Channel Videos API

ParámetrosObligatorioDescripción
urlsObligatorioURL públicas de canales de YouTube, separadas por comas o saltos de línea.
results_limitOpcionalCantidad máxima de registros elegibles que se solicitan por cada URL de entrada. Debe ser un entero positivo y su valor predeterminado es 100.

Cómo usar la YouTube Channel Videos API

Elija la profundidad con la que se inspecciona cada canal y recopile un inventario limpio de videos regulares. Un lote puede incluir varios canales, pero el límite solicitado se aplica a cada uno.

  1. Prepare las URL de canales públicos y decida si necesita una muestra reciente o un rastreo histórico más profundo.
  2. Envíe urls y results_limit por POST a /v1/youtube/channel-videos; recuerde que el límite se aplica por canal.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea de inventario llegue a succeeded o failed.
  4. Agrupe los elementos devueltos por ID de canal, deduplique por ID de video y pagine mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casos de uso de la YouTube Channel Videos API

  • Feeds de contenido de canales: Cree un feed estructurado con los videos públicos regulares de los canales seleccionados.
  • Análisis de publicación y rendimiento: Compare la frecuencia de publicación, la duración, los temas y la interacción pública entre canales.
  • Monitoreo de creadores y competidores: Siga la actividad de videos regulares de creadores, medios, marcas o competidores.
  • Creación de catálogos de videos: Alimente flujos de clasificación, resumen, búsqueda o informes sin tener que recopilar manualmente la URL de cada video.

Consejos de expertos para la YouTube Channel Videos API

  • El límite se multiplica por la cantidad de entradas. Diez canales con results_limit 100 solicitan hasta 1,000 registros de videos regulares.
  • Comience con un límite bajo al incorporar un nuevo conjunto de canales, revise la elegibilidad y suba el límite solo donde un historial más profundo resulte útil.
  • Que haya menos resultados puede significar que el canal tiene menos subidas públicas elegibles. No indica automáticamente que la tarea haya fallado.
  • No presente la respuesta como un archivo completo garantizado; la disponibilidad y el inventario público del canal pueden cambiar.
  • Use el ID de video para la deduplicación y conserve tanto el ID del canal de origen como collected_at para el análisis longitudinal.
  • Ejecute Shorts por separado si importa la mezcla de formatos. Combinar ambos solo después de la recopilación mantiene explícita la clasificación.
  • Use Channels para obtener los campos de perfil actuales en lugar de copiar las biografías y los contadores del canal en cada fila de subida.

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

  • 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 Shorts API — Recolecta Shorts públicos por canal, con miniaturas, duración, datos de publicación e interacción.
  • YouTube Channel Live Videos API — Recolecta registros de transmisiones públicas expuestas en las secciones en vivo de un canal, con contexto de origen y métricas visibles.

Explorar otras plataformas

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

YouTube Channel Videos API — FAQ

YouTube Channel Videos API recopila los videos públicos regulares de una o más URL de canales de YouTube. Devuelve títulos normalizados, 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 canales de YouTube y, de forma opcional, results_limit.

results_limit tiene un valor predeterminado de 100 y se aplica por separado a cada URL de canal. El total final puede ser menor cuando un canal tiene menos videos regulares públicos elegibles.

No. Este endpoint devuelve los videos regulares del canal. Use Shorts para los Shorts de un canal.

No. Las vistas, los Me gusta y los comentarios son valores públicos observados en el momento de la recopilación. Para construir comparaciones históricas se necesitan recopilaciones repetidas.

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