YouTubeYouTube ShortsPosts de la communautéProspection de créateursGuide API

Nouveaux endpoints de l’API YouTube : Shorts tendance, posts de la communauté, recherche de chaînes et e-mails

Huit nouveaux endpoints SocQ YouTube renvoient les Shorts tendance, la recherche de Shorts et de chaînes, les suggestions de recherche, les posts de la communauté et leurs commentaires, les vidéos associées et les e-mails professionnels des chaînes.

SocQMis à jour le 19 novembre 20269 min de lecture

SocQ renvoyait déjà les chaînes, vidéos, Shorts, commentaires, recherches, playlists et transcriptions YouTube publics. Les 7 meilleures API de scraping YouTube les compare, et le guide des transcriptions YouTube traite des sous-titres en masse. Le 2026-11-17, huit endpoints supplémentaires ont été mis en ligne sur la page de la plateforme YouTube. Ils comblent des manques pour la recherche sur les Shorts, la découverte et la prospection de créateurs, et les posts de la communauté que les créateurs publient entre deux vidéos.

Ce guide regroupe les nouveaux endpoints par usage, montre une requête pour chacun, indique le prix et précise quand l’utiliser.

Réponse rapide : envoyez un corps JSON à POST https://api.socq.ai/v1/youtube/<endpoint>. Enregistrez le task_id renvoyé, interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded, puis lisez data.results.items.

Les nouveaux endpoints YouTube en un coup d’œil

1 crédit SocQ = $0,005. Les endpoints facturés au résultat n’ont pas de frais de base : un résultat vide ne coûte rien.

EndpointCe qu’il renvoiePrix
API YouTube Trending ShortsUn échantillon récent de Shorts tendance avec chaîne, vues, likes, commentaires, durée et date de publication0,5 crédit ($0,0025) par Short
API YouTube Shorts SearchLes Shorts correspondant à un mot-clé avec lien, légende, vues et miniature verticale0,6 crédit ($0,003) par Short
API YouTube Channel SearchLes chaînes correspondant à un mot-clé avec ID, nom, abonnés, avatar et extrait de description0,6 crédit ($0,003) par chaîne
API YouTube Search SuggestionsDes suggestions de saisie semi-automatique classées pour une requête partielle, par langue et région0,5 crédit ($0,0025) par appel
API YouTube Community PostUn post de la communauté : texte complet, toutes les images, likes et chaîne0,5 crédit ($0,0025) par appel
API YouTube Community Post CommentsLes commentaires sous un post de la communauté avec auteur, likes et nombre de réponses0,3 crédit ($0,0015) par commentaire
API YouTube Related VideosLes vidéos que YouTube recommande à côté d’une vidéo0,5 crédit ($0,0025) par vidéo
API YouTube Email FinderLes e-mails professionnels publics d’une chaîne et les pages où ils ont été trouvés15 crédits ($0,075) par chaîne avec e-mail ; gratuit si aucun n’est trouvé

Authentification et flux de tâches asynchrones

Toutes les requêtes s’authentifient avec une clé API. Le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chaque collecte s’exécute comme une tâche en arrière-plan :

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

L’appel d’envoi répond immédiatement avec data.task_id et data.status. Interrogez la tâche avec cet ID :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Lorsque status vaut succeeded, la réponse contient result_count, credits_amount et la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500. Si results.has_more vaut true, passez results.next_cursor comme cursor pour lire la page suivante. Une tâche en échec porte error_message.

Chaque endpoint ci-dessous accepte aussi un callback_url facultatif. SocQ envoie un POST avec un résumé de la tâche lorsqu’elle se termine ; lisez les enregistrements depuis l’endpoint des tâches. Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même ID de tâche au lieu de renvoyer la requête. Un 402 signifie que le compte n’a plus de crédits, et un 429 que la clé a atteint une limite de débit ou de crédits.

Étudier les Shorts et la demande de recherche

Trending Shorts échantillonne les Shorts que YouTube met en avant comme tendance à l’instant présent, chacun avec titre, chaîne, vues, likes, commentaires, durée et date de publication. Tous les champs sont facultatifs ; results_limit vaut 48 par défaut et peut aller jusqu’à 200. Chaque exécution prend un nouvel échantillon, si bien que deux exécutions espacées de quelques minutes n’ont que quelques Shorts en commun. Une tâche planifiée donne donc une vue plus large sur la journée qu’un seul gros appel. (docs)

curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit": 48}'

Shorts Search renvoie les Shorts correspondant à un mot-clé dans l’ordre de recherche de YouTube, avec lien, légende, nombre de vues et miniature verticale. Les résultats de recherche ne contiennent que ces informations de base : passez les liens que vous conservez à YouTube Videos si vous avez aussi besoin des likes, des commentaires ou des détails de la chaîne. results_limit vaut 25 par défaut (de 1 à 200). (docs)

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}'

Search Suggestions renvoie les complétions que la barre de recherche de YouTube propose pour le début d’une requête, classées comme les voient les spectateurs. language vaut en par défaut et region vaut US ; modifiez-les pour voir comment le même terme de départ se ramifie sur un autre marché. Chaque appel est facturé une fois, quel que soit le nombre de suggestions. Utilisez-le pour la recherche de mots-clés, les titres et les tags. (docs)

curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "iphone 17"}'

Découvrir des créateurs et trouver leur e-mail de contact

Channel Search trouve des chaînes pour un mot-clé, dans l’ordre de YouTube, avec ID de chaîne, nom, nombre d’abonnés, avatar et l’extrait de description affiché dans les résultats. results_limit vaut 20 par défaut (de 1 à 200). C’est la première étape de la découverte de créateurs : établissez ici une liste restreinte, puis récupérez les détails avec YouTube Channels ou les vidéos avec YouTube Channel Videos. (docs)

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}'

Email Finder recherche les e-mails professionnels qu’un créateur a publiés : dans la description de la chaîne, sur les profils sociaux liés, sur les pages link-in-bio ou sur le site du créateur. Chaque adresse de emails est fournie avec les source_urls où elle a été trouvée. url accepte un lien de chaîne au format @handle ou /channel/UC.... Une chaîne avec au moins un e-mail public renvoie un résultat contenant toutes les adresses trouvées et coûte 15 crédits ($0,075) ; une chaîne qui n’en affiche aucun renvoie un résultat vide, sans frais. (docs)

curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@mkbhd"}'

Exemple de coût : recherchez 20 chaînes (12 crédits), puis lancez Email Finder sur les 20. Si 8 affichent un e-mail, cela fait 120 crédits, pour un total de 132 crédits ($0,66). Vous ne payez rien pour les 12 chaînes sans e-mail public.

Lire les posts de la communauté et leurs commentaires

Community Post lit un post à partir de son lien : texte complet, toutes les images jointes, nombre de likes et chaîne qui l’a publié. url accepte un lien https://www.youtube.com/post/{post_id} ou un lien vers l’onglet Posts d’une chaîne contenant ?lb={post_id}. Utilisez-le quand vous disposez déjà de l’URL d’un post, par exemple issue d’un résultat YouTube Community Posts. (docs)

curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

Community Post Comments collecte les commentaires sous un post, qu’il s’agisse d’un sondage, d’une annonce ou d’une publication d’images, avec la chaîne de chaque auteur, metrics.likes_count et metrics.replies_count. Les commentaires de posts sont séparés des commentaires de vidéos : c’est donc ainsi que vous lisez la réaction aux actualités d’un créateur entre deux vidéos. Les mêmes formats d’URL fonctionnent ; results_limit vaut 100 par défaut (de 1 à 1000). (docs)

curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'

Voir ce que YouTube recommande ensuite

Related Videos renvoie la liste que YouTube place à côté d’une vidéo comme suggestions à regarder ensuite : titres, chaînes, nombres de vues et miniatures. url accepte un lien watch, youtu.be, Shorts ou live. Une exécution renvoie toute la liste de recommandations, généralement une vingtaine de vidéos, facturée à la vidéo : un appel typique coûte donc environ 10 crédits ($0,05). Lancez-le sur vos propres vidéos ou sur celles d’un concurrent pour voir quelles vidéos et chaînes YouTube considère comme leurs voisines. (docs)

curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

Guides YouTube associés

Pour comparer SocQ à d’autres fournisseurs de données YouTube, consultez Les 19 meilleures alternatives à l’API YouTube. Le même flux de découverte et de prospection pour TikTok, y compris les pays des abonnés et la détection des fausses vues, est présenté dans le guide des nouveaux endpoints TikTok.

FAQ

Est-ce que je paie pour les chaînes sans e-mail public ?

Non. Une chaîne sans e-mail public renvoie un résultat vide, qui est gratuit. Une chaîne avec au moins un e-mail coûte 15 crédits, quel que soit le nombre d’adresses affichées.

Chaque exécution échantillonne ce qui est tendance à ce moment-là : des exécutions espacées de quelques minutes n’ont donc que quelques Shorts en commun. Planifiez plusieurs exécutions si vous voulez une couverture plus large.

Quelles URL de posts de la communauté sont acceptées ?

https://www.youtube.com/post/{post_id}, ou un lien vers l’onglet Posts d’une chaîne contenant ?lb={post_id}.

Shorts Search renvoie-t-il les likes et les commentaires ?

Non. Les résultats de recherche contiennent le lien, la légende, le nombre de vues et la miniature. Passez les liens à YouTube Videos pour obtenir les likes, les commentaires et les détails de la chaîne.

Comment Search Suggestions est-il facturé ?

0,5 crédit par appel, quel que soit le nombre de suggestions renvoyées.

YOUTUBE API

Tester le workflow avec une URL publique YouTube

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API YouTube