YouTube Related Videos
Les vidéos similaires sont les recommandations que YouTube aligne à côté d’une vidéo comme suggestions à regarder ensuite, chacune affichée avec son titre, sa chaîne, son nombre de vues et sa miniature. Cette liste révèle les vidéos et les chaînes que YouTube place dans le même voisinage, ce qui aide à cartographier une niche, à repérer des chaînes concurrentes et à planifier des contenus qui côtoient une vidéo cible.
Fonctionnalités de la YouTube Related Videos API
- Tous les liens de vidéo courantsLes URL de lecture, les liens courts youtu.be, les liens de Shorts et les liens de live sont tous lus pour en extraire l’ID de la vidéo.
- La liste entière en une exécutionUne seule tâche renvoie la liste complète des recommandations que YouTube affiche pour cette vidéo, généralement une vingtaine de vidéos.
- L’auteur de chaque recommandationauthor contient l’ID, le nom et l’URL de la chaîne derrière chaque vidéo recommandée.
- Vues et miniaturemetrics.views_count est extrait du nombre affiché par YouTube, par exemple 2,2 M, et media fournit la plus grande miniature.
Paramètres de la YouTube Related Videos API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | Un lien de vidéo YouTube : URL de lecture, lien youtu.be, lien de Short ou lien de live. |
Comment utiliser la YouTube Related Videos API
Envoyez un lien de vidéo et récupérez les recommandations.
- Envoyez {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} en POST à /v1/youtube/related-videos.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les recommandations dans results.items et suivez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
# Each item is one recommended video with author and metrics.views_count.Cas d’usage de la YouTube Related Videos API
- Cartographie d’une niche autour d’une vidéo : Partez d’une vidéo performante, collectez ses recommandations, puis recommencez sur ces résultats pour dessiner le groupe de vidéos que YouTube rassemble.
- Repérage des chaînes concurrentes : Comptez combien de fois chaque author.id apparaît à côté de vos propres vidéos pour voir quelles chaînes YouTube recommande régulièrement près de vous.
- Vérification des endroits où votre vidéo est recommandée : Lancez l’endpoint sur les vidéos populaires de vos concurrents et cherchez les ID de vos propres vidéos dans leurs listes.
Conseils d’expert pour la YouTube Related Videos API
- Considérez views_count comme une approximation : la valeur provient d’un texte affiché arrondi, comme 2,2 M.
- Les recommandations évoluent avec le temps : stockez collected_at avec chaque liste lorsque vous comparez plusieurs exécutions.
- Envoyez les URL de vidéos que vous retenez à YouTube Videos pour obtenir les nombres exacts, les dates de publication et les durées.
API associées
En complément de la YouTube Related 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 Channels API — Récupérez l’identité publique d’une chaîne, ses images, sa vérification et ses statistiques d’audience visibles.
- 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 Search API
- YouTube Channel Live Videos 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 Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API