youtube/
search-channels

Recherchez des chaînes YouTube par mot-clé et obtenez leurs ID, noms, nombres d’abonnés, avatars et l’extrait de description affiché par YouTube, dans l’ordre de la recherche.

YouTube Channel Search API

Mot-clé en entrée
Nombre d’abonnés
Jusqu’à 200 chaînes
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 Channel Search

Les résultats de recherche de chaînes sont les comptes de créateurs que YouTube associe à un mot-clé, chacun présenté avec son nom, son avatar, son nombre d’abonnés et les premières lignes de sa description. Les passer en revue est le moyen le plus rapide d’évaluer qui couvre un sujet, de distinguer les grandes chaînes de celles en pleine croissance et de dresser une première liste pour la recherche de créateurs ou la prospection.

Fonctionnalités de la YouTube Channel Search API

  • Uniquement des chaînesLa recherche est limitée aux chaînes : un mot-clé comme home cooking renvoie des comptes de créateurs, et non un mélange de vidéos et de playlists.
  • Nombre d’abonnés par chaînemetrics.followers_count contient le total d’abonnés extrait de l’affichage de YouTube, par exemple 3,69 M.
  • ID et liens de chaîne stablesChaque résultat comporte l’ID de chaîne UC et l’URL de chaîne construite à partir de celui-ci, prête pour les API au niveau de la chaîne.
  • Extrait de descriptiontext contient l’extrait de description affiché dans la recherche, qui précise souvent la niche ou indique un contact professionnel.

Paramètres de la YouTube Channel Search API

ParamètresObligatoireDescription
queryObligatoireLe mot-clé pour lequel trouver des chaînes, jusqu’à 100 caractères.
results_limitFacultatifNombre de chaînes à renvoyer, de 1 à 200. Valeur par défaut : 20.

Comment utiliser la YouTube Channel Search API

Lancez une recherche par mot-clé et parcourez les chaînes correspondantes page par page.

  1. Envoyez {"query": "home cooking", "results_limit": 20} en POST à /v1/youtube/search-channels.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez les chaînes dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home cooking","results_limit":20}'

# Each item is one channel with name, text and metrics.followers_count.

Cas d’usage de la YouTube Channel Search API

  • Constitution d’une présélection de créateurs : Recherchez les mots-clés de votre niche et gardez les chaînes dont followers_count se situe dans la fourchette de taille avec laquelle vous travaillez.
  • Identification des chaînes qui dominent un sujet : Comparez le nombre d’abonnés des premiers résultats d’un mot-clé pour juger si quelques grandes chaînes l’occupent.
  • Point de départ d’une étude de chaînes : Transmettez les URL de chaînes renvoyées à YouTube Channels et à YouTube Channel Videos pour analyser chaque créateur en profondeur.

Conseils d’expert pour la YouTube Channel Search API

  • Le nombre d’abonnés provient d’un texte affiché arrondi : utilisez YouTube Channels lorsque vous avez besoin du chiffre à l’unité près.
  • Lancez plusieurs formulations d’un même sujet et fusionnez les résultats par id de chaîne pour élargir la liste.
  • Transmettez les chaînes prometteuses à YouTube Email Finder pour savoir si elles publient un contact professionnel.

En complément de la YouTube Channel Search 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 Channels API — Récupérez l’identité publique d’une chaîne, ses images, sa vérification et ses statistiques d’audience visibles.
  • 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 Shorts Search API — Recherchez des Shorts par mot-clé, avec liens, légendes, nombres de vues et miniatures verticales.
  • YouTube Email Finder API — Trouvez les e-mails professionnels publics d’une chaîne à partir de son URL, avec les pages où figure chaque adresse.

Explorer d’autres plateformes

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

YouTube Channel Search API — FAQ

YouTube Channel Search API est une interface programmatique qui trouve les chaînes YouTube correspondant à un mot-clé. Elle renvoie les ID de chaîne, les noms, les nombres d’abonnés, les avatars et les extraits de description dans l’ordre de recherche de YouTube.

Réglez results_limit entre 1 et 200 ; la valeur par défaut est 20. Les résultats sont paginés automatiquement jusqu’à atteindre la limite ou la fin des résultats de YouTube.

Les résultats de recherche identifient les chaînes par leur ID de chaîne UC et leur URL. Envoyez cette URL à YouTube Channels pour obtenir le handle et le profil complet.

Non. Les requêtes utilisent votre clé API SocQ et sont facturées en crédits par chaîne renvoyée : vous n’avez ni projet Google Cloud ni quota quotidien à gérer.

Chaque chaîne renvoyée coûte 0,6 crédit : les 20 chaînes par défaut coûtent donc 12 crédits.