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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una 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_limit | Opcional | Cantidad 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.
- 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.
- 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.
- Consulte /v1/tasks/{task_id} hasta que el estado de la tarea sea succeeded o failed.
- 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 trueCasos 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.
APIs relacionadas
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.
- YouTube Channels API
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search 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