youtube/
trending-videos

Récupérez les vidéos tendance d’une catégorie comme l’actualité, les jeux vidéo ou le sport pour n’importe quel pays, classées par rang, avec chaîne, nombre de vues, durée et miniature.

YouTube Trending Videos API

7 catégories
Tous les pays
Ordre du classement
0,5 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

YouTube Trending Videos

Les pages Tendances de YouTube classent, pour chaque pays, les vidéos qui retiennent le plus l’attention dans une catégorie comme l’actualité, les jeux vidéo ou le sport, en affichant pour chacune sa position, sa chaîne, son nombre de vues, sa durée et le temps écoulé depuis sa mise en ligne. Suivre ces classements permet de voir quels sujets, jeux et créateurs percent sur un marché et à quelle vitesse une vidéo entre dans la liste ou en sort.

Fonctionnalités de la YouTube Trending Videos API

  • Les pages tendances de sept catégoriescategory sélectionne la page tendances news, gaming, sports, learning, courses, fashion ou shopping, pour que chaque tâche suive la liste que voient les spectateurs de cette catégorie.
  • N’importe quel pays via son code à deux lettresregion accepte un code comme US, GB, JP ou BR et renvoie la version de la page propre à ce pays, qui classe souvent d’autres vidéos pour la même catégorie.
  • Le rang conservé pour chaque vidéorank enregistre la position de chaque vidéo à partir de 1, avec category et region, afin qu’une ligne garde tout son sens une fois plusieurs listes réunies dans un même tableau.
  • La chaîne derrière chaque vidéo tendanceauthor contient l’ID de la chaîne, son nom, son @handle, son lien, son avatar et son badge de validation, ce qui permet de regrouper les vidéos tendance par chaîne sans seconde requête.
  • Vues, durée et miniaturemetrics.views_count, duration_seconds, thumbnail_url et l’extrait de description dans text décrivent chaque vidéo telle qu’elle apparaît sur la page tendances.

Paramètres de la YouTube Trending Videos API

ParamètresObligatoireDescription
categoryObligatoirePage tendances à lire : news, gaming, sports, learning, courses, fashion ou shopping.
regionFacultatifCode pays à deux lettres de la page tendances, par exemple US, GB ou JP. Valeur par défaut : US.
results_limitFacultatifNombre de vidéos à renvoyer depuis le haut de la liste, de 1 à 50. Valeur par défaut : 50.

Comment utiliser la YouTube Trending Videos API

Choisissez une catégorie et un pays, envoyez-les à YouTube Trending Videos API et lisez la liste classée dans la tâche terminée.

  1. Envoyez {"category": "news", "region": "US", "results_limit": 50} en POST à /v1/youtube/trending-videos et notez le task_id.
  2. Interrogez GET /v1/tasks/{task_id} toutes les quelques secondes, jusqu’à ce que status passe à succeeded.
  3. Lisez les vidéos dans results.items, triées par rank ; lorsque results.has_more vaut true, transmettez results.next_cursor pour charger la page suivante.
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"gaming","region":"GB","results_limit":10}'

# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the ranked videos once status is succeeded.

Cas d’usage de la YouTube Trending Videos API

  • Un point tendances quotidien pour un marché : Récupérez chaque matin les pages actualités et sport d’un pays et transmettez à la rédaction les titres, chaînes et nombres de vues qui percent, dans l’ordre du classement.
  • Suivre les tendances du jeu vidéo : Suivez la page gaming dans les pays où vous publiez pour repérer les jeux, formats et créateurs en hausse avant de planifier vos vidéos ou vos campagnes.
  • Comparer une catégorie d’un pays à l’autre : Lancez la même catégorie pour plusieurs codes region et alignez les listes par ID de vidéo pour voir quelles vidéos voyagent et lesquelles restent locales.
  • Constituer une liste de chaînes à contacter : Rassemblez les chaînes qui reviennent régulièrement sur la page tendances d’une catégorie, avec leur handle et leur badge de validation, comme point de départ pour des partenariats.

Conseils d’expert pour la YouTube Trending Videos API

  • Programmez la même catégorie et la même région à heure fixe et joignez les exécutions sur id ; l’évolution de rank montre quelles vidéos grimpent et lesquelles reculent.
  • Lisez published_time_text avec collected_at : la page affiche l’ancienneté sous forme de texte, comme « 15 min ago », à soustraire de l’heure de collecte si vous avez besoin d’une heure de mise en ligne approximative.
  • Réglez results_limit sur 10 ou 20 si seul le haut de la liste vous intéresse ; YouTube Trending Videos API facture chaque vidéo renvoyée.
  • Transmettez les ID collectés à YouTube Videos API pour obtenir les mentions « J’aime », les commentaires et la description complète, ou à YouTube Transcripts API pour lire ce que dit chaque vidéo tendance.

En complément de la YouTube Trending 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 Trending Videos API — FAQ

YouTube Trending Videos API est une interface programmatique qui collecte les vidéos tendance d’une catégorie YouTube, comme l’actualité, les jeux vidéo ou le sport, pour le pays choisi. Elle renvoie pour chaque vidéo son rang, son titre, sa chaîne, son nombre de vues, sa durée, sa miniature et le temps écoulé depuis sa publication.

En juillet 2025, YouTube a remplacé sa page Tendances unique par des listes de tendances propres à chaque catégorie, les tendances gaming restant sur la page Explorer consacrée au jeu vidéo. YouTube Trending Videos API lit ces pages de catégorie : vous choisissez donc celle que vous voulez suivre.

Renseignez dans region le code à deux lettres du pays, par exemple JP pour le Japon ou DE pour l’Allemagne. Chaque pays a sa propre liste, si bien qu’une même catégorie peut classer des vidéos différentes d’un marché à l’autre.

Actualités, jeux vidéo, sport, apprentissage, cours, mode et shopping. Envoyez une catégorie par tâche et lancez plusieurs tâches pour en couvrir davantage.

Jusqu’à 50 depuis le haut de la liste, selon results_limit. Une catégorie dont la liste est plus courte renvoie les vidéos qu’elle contient, et vous ne payez que les lignes reçues.

YouTube Trending Videos API facture 0,5 crédit par vidéo renvoyée : une liste complète de 50 vidéos coûte 25 crédits et le top 10 en coûte 5.