youtube/
search-shorts

Recherchez des Shorts YouTube par mot-clé et obtenez pour chaque Short son lien, sa légende, son nombre de vues, sa miniature verticale et les hashtags de sa légende, dans l’ordre de recherche de YouTube.

YouTube Shorts Search API

Mot-clé en entrée
Shorts uniquement
Jusqu’à 200 Shorts
0,6 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 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ètresObligatoireDescription
queryObligatoireLe mot-clé à rechercher dans les Shorts, jusqu’à 100 caractères.
results_limitFacultatifNombre 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.

  1. Envoyez {"query": "meal prep", "results_limit": 25} en POST à /v1/youtube/search-shorts.
  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/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.

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.

Explorer d’autres plateformes

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

YouTube Shorts Search API — FAQ

YouTube Shorts Search API est une interface programmatique qui recherche des Shorts YouTube par mot-clé. Elle renvoie le lien, la légende, le nombre de vues et la miniature verticale de chaque Short dans l’ordre de recherche de YouTube.

Envoyez l’URL du Short à YouTube Videos, qui renvoie la chaîne, les mentions « J’aime », les commentaires et la date de publication de chaque vidéo.

Réglez results_limit entre 1 et 200 ; la valeur par défaut est 25, soit environ une page de résultats Shorts.

Sa recherche n’a pas de filtre réservé aux Shorts, et videoDuration=short correspond à toutes les vidéos de moins de quatre minutes. Cet endpoint s’appuie sur la recherche Shorts de YouTube : chaque élément renvoyé est donc un Short.

Chaque Short renvoyé coûte 0,6 crédit : les 25 Shorts par défaut coûtent donc 15 crédits.