youtube/
playlist-videos

Recopile videos normalizados de URL o IDs de listas de reproducción públicas de YouTube, con títulos, contexto del canal, miniaturas, duración y procedencia de la lista en cada registro.

YouTube Playlist Videos API

Inventarios de listas de reproducción
URL o ID directo
Procedencia de la lista
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 Playlist Videos

Los videos de una lista de reproducción de YouTube son entradas agrupadas en una lista pública, con identidad del video, títulos, contexto del canal, miniaturas, duración y procedencia de la lista. Estos registros sirven para catalogar listas de reproducción, indexar series, revisar contenido y enriquecer enlaces de videos.

Funcionalidades de la YouTube Playlist Videos API

  • Entrada de varias listas por URL e IDProcesa en una tarea una o más URL públicas de listas de reproducción o IDs de lista directos, con results_limit aplicado por separado a cada lista resuelta.
  • Filas de catálogo de videos normalizadasDevuelve los IDs de video, los títulos, las URL canónicas, la identidad del canal, una miniatura, la duración en segundos y la hora de recopilación en una estructura consistente.
  • Procedencia de la lista y de su propietarioConserva el ID y el título de la lista, el texto legible de la duración y el contexto del propietario de la lista cuando una fila de video no expone sus propios campos de canal.

Parámetros de la YouTube Playlist Videos API

ParámetrosObligatorioDescripción
urlsObligatorioUna o más URL públicas de listas de reproducción con un valor en la consulta list, o IDs de lista directos, separados por comas o saltos de línea.
results_limitOpcionalCantidad máxima de registros que se conservan del arreglo de videos devuelto por cada lista; el valor predeterminado es 100 y acepta enteros de 10 a 2,000.

Cómo usar la YouTube Playlist Videos API

Envíe referencias de listas de reproducción públicas conocidas como una tarea asíncrona y, cuando la tarea termine con éxito, pagine las filas de videos normalizadas almacenadas.

  1. Prepare una o más URL públicas de listas de reproducción con un valor en la consulta list, o IDs de lista directos, y elimine las referencias duplicadas.
  2. Envíe por POST urls y, de forma opcional, un results_limit de 10 a 2,000 a /v1/youtube/playlist-videos, y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que el estado de la tarea sea succeeded o failed.
  4. Lea data.results.items y continúe con results.next_cursor mientras results.has_more sea true; concilie los IDs de lista y de video con su conjunto de origen.
curl -X POST "https://api.socq.ai/v1/youtube/playlist-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/playlist?list=PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la YouTube Playlist Videos API

  • Inventarios de listas de reproducción públicas: Cree un inventario estructurado de IDs de video, títulos, URL, identidad del canal, miniaturas, duración y procedencia de la lista para las listas de reproducción públicas seleccionadas.
  • Indexación de cursos y series: Indexe los títulos de las listas junto con los títulos de sus videos, el contexto del canal, las duraciones y los enlaces de origen para organizar cursos, charlas o colecciones por episodios públicos.
  • Listas semilla para enriquecer videos: Use las URL canónicas y los IDs de video devueltos como una cola deduplicada para flujos separados de detalle, transcripción, revisión o archivo.

Consejos de expertos para la YouTube Playlist Videos API

  • Use un ID de lista directo o una URL cuyo valor de la consulta list esté completo; el resto de la URL no se usa para resolver la lista, y una URL sin list se omite.
  • Trate results_limit como un tope por lista sobre el primer arreglo de videos devuelto, no como una garantía de extracción profunda de una lista grande.
  • Canonice cada lista de reproducción a una sola representación antes de armar lotes, porque solo se eliminan las cadenas exactamente duplicadas y las variantes de URL de la misma lista pueden generar trabajo repetido.
  • Compare los valores devueltos de extra.playlist_id y de id de video con su conjunto de entrada, porque las entradas privadas, eliminadas, restringidas, ocultas, mal formadas o no disponibles pueden faltar.
  • Use collected_at para el linaje del registro y solicite detalles de video por separado cuando necesite fechas de publicación o interacción, porque metrics está vacío y created_at es null.

Además de la YouTube Playlist 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 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 Playlist Videos API — FAQ

YouTube Playlist Videos API es una interfaz programática que recopila filas de videos normalizadas de URL públicas de listas de reproducción de YouTube o de IDs de lista directos. Devuelve identidad del video, títulos, URL canónicas, contexto del canal, miniaturas, duración, procedencia de la lista y hora de recopilación.

Envíe una lista urls no vacía con URL de listas de reproducción que tengan un valor en la consulta list, o con IDs de lista directos. results_limit es opcional, tiene un valor predeterminado de 100, acepta de 10 a 2,000 y se aplica por separado a cada lista.

Cada registro puede incluir el ID del video, el título, la URL canónica, el ID, el handle, el nombre y la URL del canal, una miniatura, la duración en segundos, la hora de recopilación, el ID y el título de la lista, y el texto legible de la duración. El objeto metrics normalizado está vacío y created_at es null.

No. No se conservan la posición en la lista, el total de videos, la reproducibilidad ni el estado de los elementos no disponibles, y las entradas faltantes no se representan con registros de relleno.

No. El límite acota los videos que se conservan de un arreglo de videos devuelto por lista; el recopilador actual no solicita páginas de continuación del origen.

Una lista puede producir menos registros cuando es privada, no está disponible, está mal formada, no se puede resolver, tiene restricciones o contiene entradas ocultas e inaccesibles. Una URL sin un valor de list no vacío se omite.

El uso cuesta 0.5 créditos por cada registro de video normalizado devuelto, sin cargo base. Los resultados vacíos no generan cargo por resultado según la política actual para resultados vacíos.