YouTube Shorts Search
Les résultats de recherche de Shorts sont les vidéos verticales que YouTube classe pour un mot-clé dans son filtre Shorts, chacune présentée avec une légende, un nombre de vues et une miniature au format 9:16. Les comparer révèle les accroches et les angles qui captent l’attention sur un sujet et vous fournit un ensemble de liens de Shorts à étudier ou à suivre.
Fonctionnalités de la YouTube Shorts Search API
- Des Shorts et rien d’autreLes résultats proviennent de la recherche Shorts de YouTube : les vidéos longues, les chaînes et les playlists restent hors de la liste.
- Légende, vues et miniaturetext est la légende du Short, metrics.views_count est extrait du nombre affiché, et media contient la miniature verticale avec ses dimensions.
- Hashtags issus de la légendeLes tags écrits dans la légende sont listés dans hashtags, prêts à être comptés sur un ensemble de résultats.
- Liens de Shorts prêts à l’emploiChaque résultat comporte une URL youtube.com/shorts/ et l’ID de la vidéo pour les consultations ultérieures.
Paramètres de la YouTube Shorts Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Le mot-clé à rechercher dans les Shorts, jusqu’à 100 caractères. |
results_limit | Facultatif | Nombre de Shorts à renvoyer, de 1 à 200. Valeur par défaut : 25. |
Comment utiliser la YouTube Shorts Search API
Lancez une recherche par mot-clé et lisez les Shorts correspondants.
- Envoyez {"query": "meal prep", "results_limit": 25} en POST à /v1/youtube/search-shorts.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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/search-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"meal prep","results_limit":25}'
# Each item is one Short with text, metrics.views_count and a shorts URL.Cas d’usage de la YouTube Shorts Search API
- Recherche d’accroches sur un sujet : Lisez les légendes des Shorts les plus vus pour un mot-clé afin de voir quelles entrées en matière et quelles promesses attirent des vues.
- Suivi d’un mot-clé dans les Shorts : Répétez la même recherche à intervalles réguliers et comparez les ID de vidéos qui entrent dans les résultats ou en sortent.
- Collecte de Shorts pour une analyse approfondie : Rassemblez les URL shorts d’un thème et transmettez-les à YouTube Videos pour obtenir la chaîne, les mentions « J’aime » et la date de publication.
Conseils d’expert pour la YouTube Shorts Search API
- Les résultats de recherche ne contiennent que la légende et le nombre de vues : envoyez les URL retenues à YouTube Videos lorsque vous avez besoin de la chaîne ou des mentions « J’aime ».
- Le nombre de vues provient d’un texte affiché arrondi, comme 635 k ; comparez des ordres de grandeur plutôt que des totaux exacts.
- Les pages suivantes répètent certains Shorts des pages précédentes : les résultats sont donc dédoublonnés par ID de vidéo avant d’être comptés dans results_limit.
API associées
En complément de la YouTube Shorts Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques YouTube.
- YouTube Comments API — Collectez les commentaires publics, auteurs, l’engagement, vidéos sources et le contexte de la conversation.
- 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 Search API — Recherchez des vidéos publiques classiques par mot-clé avec filtres de métadonnées pris en charge.
- YouTube Hashtag Search API — Trouvez des vidéos publiques dans les fils de hashtags, pour tous les contenus ou uniquement les Shorts.
- YouTube Related Videos API — Listez les vidéos recommandées à côté d’une URL de vidéo, avec titres, chaînes, vues et miniatures.
- YouTube Channel Search API — Trouvez des chaînes par mot-clé, avec noms, nombres d’abonnés, avatars et extraits de description.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API