youtube/
shorts

Collectez les Shorts publics à partir d’URL de chaînes YouTube, avec titres, contexte de la chaîne, miniatures, durée, informations de publication et engagement visible, le tout normalisé.

YouTube Shorts API

Shorts
Découverte par chaîne
Indicateurs publics
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

YouTube Shorts

Les Shorts YouTube sont des vidéos au format court, avec titre, contexte de la chaîne, miniatures, durée, informations de publication, classification de la source et engagement visible. Ces signaux de contenu et de performance servent à étudier un format, à comparer des créateurs, à surveiller des tendances et à analyser des campagnes.

Fonctionnalités de la YouTube Shorts API

  • Collecte de Shorts sur plusieurs chaînesRécupérez en une seule requête les Shorts publics de plusieurs URL de chaînes.
  • Limite de résultats par chaîneFixez un results_limit distinct pour chaque chaîne fournie, 100 par défaut.
  • Métadonnées de Short normaliséesRenvoie l’identité normalisée du Short, ses métadonnées de contenu, ses miniatures, sa durée, sa date de publication et la chaîne qui l’a publié.
  • Indicateurs d’engagement ponctuelsLes nombres publics de vues, de mentions « J’aime » et de commentaires accompagnent collected_at, pour comparer plus tard.
  • Périmètre Shorts défini par la plateformeS’appuie sur la classification Shorts de YouTube plutôt que de définir le format court uniquement par la durée ou l’orientation.

Paramètres de la YouTube Shorts API

ParamètresObligatoireDescription
urlsObligatoireURL de chaînes YouTube publiques, séparées par des virgules ou des retours à la ligne.
results_limitFacultatifNombre maximal d’enregistrements éligibles à demander pour chaque URL fournie. Doit être un entier positif ; vaut 100 par défaut.

Comment utiliser la YouTube Shorts API

Constituez un flux propre de contenus au format court pour un ensemble de chaînes connues. La tâche sépare la classification de la plateforme des règles de format personnalisées que vous appliquerez peut-être ensuite.

  1. Préparez des URL de chaînes publiques ; les URL de Shorts individuels relèvent de Videos lorsque vous avez besoin d’une consultation directe.
  2. Envoyez urls et results_limit en POST à /v1/youtube/shorts, en tenant compte du fait que la limite s’applique à chaque chaîne.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que l’inventaire des chaînes soit terminé.
  4. Indexez les résultats par ID de Short, gardez le contexte de la chaîne et de la collecte, et paginez tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Cas d’usage de la YouTube Shorts API

  • Suivi de l’activité en format court : Suivez les Shorts publics publiés par des créateurs, des marques, des éditeurs ou des concurrents que vous avez sélectionnés.
  • Comparaison des performances des Shorts : Comparez la fréquence de publication, la durée, les vues, les mentions « J’aime » et les commentaires de plusieurs chaînes choisies.
  • Catalogues de contenus courts : Constituez une collection normalisée de Shorts publics pour la recherche interne, la revue ou le reporting.
  • Analyse de sujets et de tendances : Exploitez titres, descriptions, hashtags, données de chaîne et indicateurs publics dans des workflows de classification ou de recherche.

Conseils d’expert pour la YouTube Shorts API

  • Ne reclassez pas les résultats avec un seuil de durée universel. La classification publique des formats de YouTube fait foi pour cet endpoint.
  • La limite s’applique par chaîne et c’est un plafond, pas une garantie. Certaines chaînes ont peu de Shorts publics éligibles, voire aucun.
  • Servez-vous de l’ID renvoyé pour dédoublonner : un même élément peut apparaître ailleurs dans votre système sous d’autres formes d’URL publiques.
  • Gardez collected_at avec les indicateurs, car les compteurs visibles d’un Short peuvent évoluer vite après sa publication.
  • Cet endpoint ne cherche pas par mot-clé. Partez de Search pour découvrir des sujets, puis faites passer par Videos les URL de Shorts connues si nécessaire.
  • Collectez Channel Videos à part lorsque vous voulez comparer proprement les publications au format court et celles au format classique.
  • Associez Channels par ID de chaîne pour les champs de profil et d’audience, au lieu de répéter sur chaque élément des métadonnées de chaîne susceptibles de changer.

En complément de la YouTube 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 Channel Live Videos API — Collectez les diffusions publiques exposées sur les espaces live d’une chaîne, avec contexte source et indicateurs visibles.

Explorer d’autres plateformes

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

YouTube Shorts API — FAQ

YouTube Shorts API collecte les Shorts accessibles publiquement à partir d’une ou plusieurs URL de chaînes YouTube. Elle renvoie des titres, des informations sur la chaîne, des miniatures, la durée, les dates de publication, des indicateurs d’engagement et l’heure de collecte, le tout normalisé.

Envoyez une ou plusieurs URL de chaînes YouTube publiques et, si vous le souhaitez, un results_limit.

L’endpoint suit la classification Shorts de YouTube et ne se limite pas à une règle fixe de durée ou de format d’image.

results_limit vaut 100 par défaut et s’applique séparément à chaque URL de chaîne. Le total final peut être plus bas lorsqu’une chaîne compte moins de Shorts publics éligibles.

Non. Les vues, les mentions « J’aime » et les commentaires sont des valeurs publiques observées au moment de la collecte. Pour comparer dans le temps, il faut répéter les collectes.

L’utilisation coûte 0,5 crédit pour chaque résultat de Short normalisé renvoyé.