youtube/
related-videos

Listez les vidéos que YouTube recommande à côté d’une vidéo à partir de son URL, avec le titre, la chaîne, le nombre de vues et la miniature de chaque recommandation, en une seule exécution.

YouTube Related Videos API

URL de vidéo en entrée
Recommandations « À suivre »
Chaîne et vues
0,5 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlObligatoireUn 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.

  1. Envoyez {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} en POST à /v1/youtube/related-videos.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

Combinez les données YouTube avec les données publiques d’autres plateformes sociales prises en charge.

YouTube Related Videos API — FAQ

YouTube Related Videos API est une interface programmatique qui liste, à partir de l’URL d’une vidéo, les vidéos que YouTube recommande à côté de celle-ci. Elle renvoie le titre, la chaîne, le nombre de vues et la miniature de chaque recommandation.

Elle renvoie la liste entière que YouTube affiche pour cette vidéo, généralement une vingtaine de vidéos.

Oui. Les liens de Shorts, les liens youtu.be, les liens de live et les URL de lecture classiques sont tous acceptés.

Plus maintenant. L’API officielle Data API ne prend plus en charge le paramètre de recherche relatedToVideoId depuis le 7 août 2023 : cet endpoint vous permet donc de lire la liste que YouTube affiche à côté d’une vidéo.

Chaque vidéo recommandée renvoyée coûte 0,5 crédit : une liste type de 20 vidéos coûte donc 10 crédits.