YouTube Playlist Videos
Les vidéos d’une playlist YouTube publique sont des entrées regroupées sous un même titre, chacune avec son identité de vidéo, son titre, le contexte de sa chaîne, ses miniatures, sa durée et l’origine de la playlist. Ces enregistrements permettent de cataloguer des playlists, d’indexer des séries, de passer des contenus en revue et d’enrichir des liens vidéo.
Fonctionnalités de la YouTube Playlist Videos API
- Entrée par URL et par ID sur plusieurs playlistsTraitez dans une même tâche une ou plusieurs URL de playlists publiques ou ID bruts de playlists, results_limit s’appliquant séparément à chaque playlist résolue.
- Lignes de catalogue vidéo normaliséesID de vidéos, titres, URL canoniques, identité de la chaîne, une miniature, durée en secondes et heure de collecte sont renvoyés dans une structure homogène.
- Origine de la playlist et de son propriétaireConserve l’ID et le titre de la playlist, la durée sous forme lisible et le contexte du propriétaire de la playlist lorsqu’une ligne de vidéo n’expose pas ses propres champs de chaîne.
Paramètres de la YouTube Playlist Videos API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une ou plusieurs URL de playlists publiques contenant une valeur de requête list, ou des ID bruts de playlists, séparés par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre maximal d’enregistrements à conserver dans le tableau de vidéos renvoyé pour chaque playlist ; vaut 100 par défaut et accepte les entiers de 10 à 2 000. |
Comment utiliser la YouTube Playlist Videos API
Envoyez des références de playlists publiques connues sous forme de tâche asynchrone, puis parcourez page par page les lignes de vidéos normalisées enregistrées une fois la tâche réussie.
- Préparez une ou plusieurs URL de playlists publiques contenant une valeur de requête list, ou des ID bruts de playlists, et supprimez les références en double.
- Envoyez urls et, si vous le souhaitez, un results_limit de 10 à 2 000 en POST à /v1/youtube/playlist-videos, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que le statut de la tâche soit succeeded ou failed.
- Lisez data.results.items et poursuivez avec results.next_cursor tant que results.has_more vaut true ; rapprochez les ID de playlists et de vidéos de votre ensemble source.
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 trueCas d’usage de la YouTube Playlist Videos API
- Inventaires de playlists publiques : Constituez un inventaire structuré d’ID de vidéos, de titres, d’URL, d’identités de chaînes, de miniatures, de durées et d’origines de playlists pour les playlists publiques de votre choix.
- Indexation de cours et de séries : Indexez les titres de playlists avec ceux de leurs vidéos, le contexte des chaînes, les durées et les liens sources pour organiser des cours, des conférences ou des collections d’épisodes publics.
- Listes de départ pour enrichir des vidéos : Servez-vous des URL canoniques et des ID de vidéos renvoyés comme file dédoublonnée pour des workflows distincts de détails, de transcription, de revue ou d’archivage.
Conseils d’expert pour la YouTube Playlist Videos API
- Utilisez soit un ID brut de playlist, soit une URL dont la valeur de requête list est renseignée : les autres parties de l’URL ne servent pas à résoudre la playlist, et une URL sans list est ignorée.
- Voyez results_limit comme un plafond par playlist sur le premier tableau de vidéos renvoyé, et non comme la garantie d’une extraction en profondeur pour une grande playlist.
- Ramenez chaque playlist à une seule représentation avant de constituer des lots, car seules les chaînes strictement identiques sont supprimées et des variantes d’URL d’une même playlist peuvent provoquer un travail répété.
- Comparez les valeurs extra.playlist_id et id de vidéo renvoyées avec votre ensemble d’entrée, car des entrées privées, supprimées, restreintes, masquées, mal formées ou indisponibles peuvent être absentes.
- Utilisez collected_at pour la traçabilité des enregistrements et demandez séparément les détails des vidéos si vous avez besoin des dates de publication ou de l’engagement, car metrics est vide et created_at est null.
API associées
En complément de la YouTube Playlist Videos API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques YouTube.
- YouTube Channel Videos API — Collectez les vidéos publiques classiques à partir d’URL de chaînes, hors Shorts et lives.
- YouTube Comments API — Collectez les commentaires publics, auteurs, l’engagement, vidéos sources et le contexte de la conversation.
- YouTube Transcripts API — Récupérez les transcriptions en texte brut disponibles, avec choix facultatif de la langue.
- YouTube Videos API — Récupérez les métadonnées, miniatures, durée et l’engagement à partir d’URL de vidéos ou de Shorts connues.
- YouTube Shorts API — Collectez par chaîne les Shorts publics, miniatures, durée, informations de publication et l’engagement.
- YouTube Channel Live Videos API — Collectez les diffusions publiques exposées sur les espaces live d’une chaîne, avec contexte source et indicateurs 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