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ètres | Obligatoire | Description |
|---|---|---|
category | Obligatoire | Page tendances à lire : news, gaming, sports, learning, courses, fashion ou shopping. |
region | Facultatif | Code pays à deux lettres de la page tendances, par exemple US, GB ou JP. Valeur par défaut : US. |
results_limit | Facultatif | Nombre 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.
- Envoyez {"category": "news", "region": "US", "results_limit": 50} en POST à /v1/youtube/trending-videos et notez le task_id.
- Interrogez GET /v1/tasks/{task_id} toutes les quelques secondes, jusqu’à ce que status passe à succeeded.
- 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.
API associées
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.
- 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 Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API