YouTube Search
Les résultats de YouTube Search sont des vidéos publiques classiques qui correspondent à un mot-clé ou à une expression, avec titres, chaînes, miniatures, durée, informations de publication et engagement visible. Ces enregistrements aident à repérer des sujets, à mener des recherches de contenu, à suivre des concurrents et à analyser des opportunités.
Fonctionnalités de la YouTube Search API
- Découverte de vidéos sans URLTrouvez des vidéos publiques classiques sans en connaître les URL au préalable.
- Tri des résultatsTriez les résultats par pertinence, date de publication, note ou nombre de vues public.
- Fenêtres de publicationFiltrez les résultats sur la dernière heure, le dernier jour, la dernière semaine, le dernier mois ou la dernière année.
- Filtres de durée et de sous-titresFiltrez par durée courte, moyenne ou longue et exigez la présence de sous-titres si nécessaire.
- Résultats vidéo normalisésMétadonnées vidéo normalisées, informations sur la chaîne, miniatures, durée, données de publication et indicateurs publics sont renvoyés.
Paramètres de la YouTube Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé ou expression servant à trouver des vidéos publiques. |
results_limit | Facultatif | Nombre maximal de résultats vidéo publics à demander. Doit être un entier positif ; vaut 100 par défaut. |
sort_by | Facultatif | Ordre des résultats. Vaut relevance par défaut. |
published_within | Facultatif | Fenêtre de publication facultative, mesurée à partir du moment de la requête. |
duration | Facultatif | Catégorie de durée YouTube facultative. |
has_captions | Facultatif | Filtre facultatif de disponibilité des sous-titres. Laissez-le intact pour ne pas l’appliquer. |
Comment utiliser la YouTube Search API
Rédigez la requête comme une stratégie de recherche, pas comme un simple mot-clé. Partez d’un périmètre assez large pour observer le paysage, puis ajoutez un filtre à la fois afin de voir quel choix a écarté des candidats.
- Définissez le sujet et la question : meilleures correspondances thématiques, couverture la plus récente, contenus très vus ou candidats prêts pour la transcription.
- Envoyez query et results_limit en POST à /v1/youtube/search, avec uniquement le tri et les filtres utiles à cette question.
- Stockez la requête complète avec le task_id, puis interrogez /v1/tasks/{task_id} jusqu’à ce que la découverte réussisse ou échoue.
- Dédoublonnez les résultats par ID de vidéo, conservez le contexte de classement et collected_at, et paginez tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"NASA Artemis","results_limit":10,"sort_by":"date","published_within":"month","duration":"medium","has_captions":true}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Cas d’usage de la YouTube Search API
- Étude de sujets et de marchés : Repérez des vidéos publiques sur des produits, des secteurs, des organisations, des événements ou des sujets émergents.
- Repérage de créateurs et de concurrents : Servez-vous des résultats de recherche et des informations sur les chaînes qui publient pour identifier les créateurs, marques ou concurrents pertinents.
- Veille sur les vidéos récentes : Combinez tri par date et fenêtres de publication pour collecter des vidéos récentes à examiner ou à analyser.
- Jeux de données prêts pour la transcription : Exigez la présence de sous-titres pour trouver des vidéos à transcrire, à résumer, à classer ou à indexer.
Conseils d’expert pour la YouTube Search API
- Testez deux ou trois variantes précises de la requête plutôt que de loger tous les concepts dans une seule longue expression. Les recoupements sont souvent aussi instructifs que les différences.
- Ajoutez les filtres progressivement. Si vous imposez d’un coup fenêtre de publication, durée et sous-titres, un résultat vide ne dit guère quelle contrainte était trop étroite.
- Associez date et published_within pour la veille ; relevance sans fenêtre répond à une question de recherche différente, plus large.
- Le classement n’est pas stable. Enregistrez la requête, l’ID de tâche, l’ID de vidéo et collected_at chaque fois que la position ou la composition de l’échantillon compte.
- results_limit est un plafond, pas une garantie d’exhaustivité. L’éligibilité publique et les filtres choisis peuvent donner moins d’enregistrements.
- Dédoublonnez entre variantes de requête par ID de vidéo, mais gardez la trace de la requête qui a produit chaque correspondance pour une analyse de pertinence ultérieure.
- Une fois l’URL connue, utilisez Videos pour des détails actualisés et Transcripts pour le texte des sous-titres disponibles, plutôt que de relancer la recherche.
API associées
En complément de la YouTube 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 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 Hashtag Search API — Trouvez des vidéos publiques dans les fils de hashtags, pour tous les contenus ou uniquement les Shorts.
- 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 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 Related Videos API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API