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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL públicas de canales de YouTube, 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. |
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.
- Prepare las URL de canales públicos y decida si necesita una muestra reciente o un rastreo histórico más profundo.
- Envíe urls y results_limit por POST a /v1/youtube/channel-videos; recuerde que el límite se aplica por canal.
- Consulte /v1/tasks/{task_id} hasta que la tarea de inventario llegue a succeeded o failed.
- 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=50Casos 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.
APIs relacionadas
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.
- YouTube Search 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 Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API