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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL de chaînes YouTube publiques, séparées par des virgules ou des retours à la ligne. |
results_limit | Facultatif | Nombre 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.
- 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.
- Envoyez urls et results_limit en POST à /v1/youtube/shorts, en tenant compte du fait que la limite s’applique à chaque chaîne.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que l’inventaire des chaînes soit terminé.
- 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=50Cas 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.
API associées
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.
- YouTube Search 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
- YouTube Trending Videos API