youtube/
trending-shorts

Échantillonnez les Shorts en tendance sur YouTube en ce moment, sans aucune entrée, avec titres, chaînes, vues, mentions « J’aime », commentaires, durée et heure exacte de publication.

YouTube Trending Shorts API

Aucune entrée requise
Nouvel échantillon à chaque exécution
Vues, mentions « J’aime », commentaires
0,5 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

YouTube Trending Shorts

Les Shorts en tendance sont les vidéos verticales que YouTube pousse vers un large public en ce moment, chacune avec son titre, la chaîne qui la publie, ses nombres de vues, de mentions « J’aime » et de commentaires, sa durée et l’heure exacte de sa mise en ligne. Lus ensemble, ces signaux montrent quels sujets, formats et créateurs percent, et à quelle vitesse un Short accumule des vues après sa publication.

Fonctionnalités de la YouTube Trending Shorts API

  • Directement depuis le vivier des tendancesRien à renseigner : chaque exécution tire les Shorts que YouTube met en avant à cet instant, environ 48 par tirage, et les tirages successifs sont fusionnés sans doublons jusqu’à results_limit.
  • Trois indicateurs d’engagement par Shortmetrics contient les nombres exacts de vues et de mentions « J’aime » ainsi que le nombre de commentaires affiché par YouTube, ce qui distingue un Short très commenté d’un Short simplement regardé.
  • Chaîne rattachée à chaque Shortauthor contient l’ID, le handle, le nom, l’URL et l’avatar de la chaîne, prêts à être transmis aux API au niveau de la chaîne.
  • Heure de publication et duréepublished_at donne l’heure précise de mise en ligne en UTC et duration_seconds la durée : ensemble, ils indiquent à quel point un Short en tendance est récent et long.
  • Hashtags extraits de la légendeLes tags écrits dans le titre ou la description sont listés dans hashtags, sans le # initial.

Paramètres de la YouTube Trending Shorts API

ParamètresObligatoireDescription
results_limitFacultatifNombre de Shorts en tendance à renvoyer, de 1 à 200. Valeur par défaut : 48.

Comment utiliser la YouTube Trending Shorts API

Envoyez un nombre de résultats facultatif, puis lisez les Shorts une fois la tâche terminée.

  1. Envoyez {"results_limit": 48} en POST à /v1/youtube/trending-shorts ; le corps de la requête peut aussi être vide.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les Shorts dans results.items et suivez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit":48}'

# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.

Cas d’usage de la YouTube Trending Shorts API

  • Instantanés quotidiens des tendances : Lancez l’endpoint à heures fixes et stockez chaque lot pour voir quels sujets et formats reviennent dans les Shorts en tendance.
  • Repérage des créateurs qui percent : Comparez views_count et published_at pour trouver les chaînes dont les vidéos récentes atteignent des millions de vues en quelques jours.
  • Veille sur les hashtags des Shorts : Comptez les hashtags des Shorts en tendance pour voir quels tags accompagnent les vidéos courtes virales cette semaine.

Conseils d’expert pour la YouTube Trending Shorts API

  • Chaque exécution est un nouvel échantillon : conservez l’id de chaque Short stocké et ignorez les doublons lorsque vous fusionnez des exécutions espacées de quelques minutes.
  • Divisez views_count par le nombre d’heures écoulées depuis published_at pour classer les Shorts selon leur vitesse plutôt que selon leur total de vues.
  • Envoyez author.url à YouTube Channels lorsque vous avez aussi besoin du nombre d’abonnés et de la description de la chaîne.

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

YouTube Trending Shorts API est une interface programmatique qui échantillonne les Shorts que YouTube met actuellement en avant comme tendances, sans aucune recherche à saisir. Elle renvoie pour chaque Short le titre, la chaîne, les nombres de vues, de mentions « J’aime » et de commentaires, la durée et l’heure de publication.

Chaque exécution tire un nouvel échantillon du vivier des tendances : deux exécutions espacées de quelques minutes n’ont que quelques Shorts en commun. Programmer plusieurs exécutions et les fusionner par id donne une vue plus large de ce qui est en tendance.

Réglez results_limit entre 1 et 200 ; la valeur par défaut est 48, soit environ un tirage du vivier des tendances.

Les vues et les mentions « J’aime » le sont : views_count et likes_count sont des entiers complets relevés sur chaque Short. comments_count reprend le chiffre affiché par YouTube, si bien que les nombres supérieurs à mille sont arrondis, par exemple 4 800 pour 4,8 k, et les mentions « J’aime » ou les commentaires valent null lorsqu’un créateur les masque.

Il n’existe pas de paramètre de pays. Chaque exécution renvoie les Shorts présents dans le vivier des tendances à cet instant : programmez des exécutions et fusionnez-les par id pour suivre l’évolution du vivier.

Chaque Short renvoyé coûte 0,5 crédit : les 48 Shorts par défaut coûtent donc 24 crédits.