youtube/
community-posts

Collectez les publications de la communauté YouTube à partir d’URL de chaînes, avec texte des publications, identité de la chaîne, horodatages, références d’images et contexte source, sous forme d’enregistrements normalisés.

YouTube Community Posts API

Onglet Communauté
URL de chaîne en entrée
Références d’images
0,5 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 Community Posts

Les publications de la communauté YouTube sont les messages publics postés dans l’onglet Communauté d’une chaîne, avec leur texte, l’identité de la chaîne qui les signe, l’heure de publication, des liens publics et d’éventuelles images jointes. Ces enregistrements servent à dresser l’inventaire du fil d’une chaîne, à relire des annonces et à analyser les habitudes de publication entre chaînes.

Fonctionnalités de la YouTube Community Posts API

  • Collecte par URL sur plusieurs chaînesAcceptez des URL de chaînes publiques complètes aux chemins @handle, /channel/, /c/ ou /user/, avec un plafond de résultats appliqué à chaque chaîne séparément.
  • Enregistrements de publications normalisésID de publication publics, URL de la communauté, texte, dates de publication et de collecte sont renvoyés dans une structure homogène.
  • Lien entre la chaîne et ses publicationsChaque publication reste rattachée à l’ID de sa chaîne, à son identifiant, à son nom affiché, à l’URL publique de la chaîne et à l’URL source envoyée.
  • Références des images jointesLes images exposées dans une publication deviennent des entrées média normalisées, pour que les actualités en images restent liées à leur enregistrement.
  • Parcours borné du filSuit les pages de continuation de la source pour chaque chaîne, supprime les doublons par ID ou par URL et s’arrête à la limite choisie, à la fin du fil ou au plafond de 100 pages.

Paramètres de la YouTube Community Posts API

ParamètresObligatoireDescription
urlsObligatoireURL obligatoires de chaînes YouTube publiques, séparées par des virgules ou des retours à la ligne. Les chemins pris en charge commencent par @handle, /channel/, /c/ ou /user/.
results_limitFacultatifNombre maximal de publications de la communauté à collecter pour chaque chaîne fournie. Vaut 100 par défaut et accepte les entiers de 20 à 2000.

Comment utiliser la YouTube Community Posts API

Envoyez une ou plusieurs chaînes publiques connues sous forme de tâche asynchrone, puis lisez les publications de la communauté enregistrées une fois la tâche terminée.

  1. Préparez des URL complètes de chaînes YouTube publiques, avec un chemin @handle, /channel/, /c/ ou /user/.
  2. Envoyez urls et un results_limit de 20 à 2000 en POST à /v1/youtube/community-posts.
  3. Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} tant que la tâche est queued, running ou retrying.
  4. Après la réussite, lisez data.results.items et transmettez data.results.next_cursor comme cursor dans la requête de tâche tant que data.results.has_more vaut true.
curl -X POST "https://api.socq.ai/v1/youtube/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

Cas d’usage de la YouTube Community Posts API

  • Inventaire du fil Communauté d’une chaîne : Avec les ID de publications, les URL, le texte, les horodatages et le contexte de la chaîne source, constituez un fil consultable pour les chaînes publiques de votre sélection.
  • Relecture des annonces et des visuels : Examinez le texte public des publications avec les références d’images conservées, pour comparer la façon dont les chaînes présentent leurs nouveautés en dehors de leurs vidéos.
  • Analyse de publication entre chaînes : Regroupez les publications normalisées par identité de chaîne et par date pour comparer l’activité de la communauté sur un ensemble de chaînes connues.

Conseils d’expert pour la YouTube Community Posts API

  • Envoyez l’URL complète d’une chaîne sur un hôte YouTube pris en charge ; les URL de vidéos, de publications ou de playlists et les valeurs brutes qui ne sont pas des URL ne respectent pas la spécification d’entrée des chaînes publiques.
  • Dimensionnez les requêtes multi-chaînes avec soin, car results_limit s’applique à chaque URL : trois chaînes à 20 peuvent demander jusqu’à 60 publications enregistrées.
  • Voyez results_limit comme un plafond : une chaîne sans onglet Communauté public, ou dont le fil visible est plus court, peut renvoyer moins d’enregistrements.
  • N’utilisez cursor qu’avec GET /v1/tasks/{task_id} ; la continuation côté source est gérée en interne et n’est pas un paramètre de requête public pour cet endpoint.
  • Dédoublonnez les enregistrements stockés par ID de publication, avec l’URL en solution de repli, et conservez extra.input_url quand plusieurs chaînes envoyées sont combinées.
  • Vérifiez text, media et created_at avant toute exploitation en aval : les enregistrements normalisés actuels ne gardent ni les choix de sondage ni les métadonnées de vidéo intégrée.

En complément de la YouTube Community Posts 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 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 Community Post API — Lisez une publication de la communauté à partir de son lien, avec texte intégral, images jointes, mentions « J’aime » et chaîne qui l’a publiée.
  • YouTube Community Post Comments API — Collectez les commentaires d’une publication de la communauté à partir de son lien, avec chaînes des auteurs, nombres de mentions « J’aime » et nombres de réponses.

Explorer d’autres plateformes

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

YouTube Community Posts API — FAQ

YouTube Community Posts API est une interface programmatique pour collecter les publications publiques de l’onglet Communauté à partir d’URL de chaînes YouTube prises en charge. Elle renvoie les ID de publications, les URL, le texte, l’identité de la chaîne, les horodatages, les références d’images et le contexte de la chaîne source.

Utilisez des URL youtube.com complètes dont le premier segment de chemin est @handle, /channel/, /c/ ou /user/. Les URL de vidéos, de publications, de playlists ou d’un autre hôte ne sont pas acceptées comme entrées de chaîne.

results_limit vaut 100 par défaut, accepte les entiers de 20 à 2000 et s’applique séparément à chaque URL de chaîne envoyée. Deux chaînes à 100 peuvent donc demander jusqu’à 200 enregistrements de publications.

Un enregistrement peut comprendre l’ID et l’URL de la publication, son texte public, l’ID, l’identifiant, le nom et l’URL de la chaîne, des champs de compteurs normalisés, les références d’images conservées, les heures de publication et de collecte, ainsi que extra.input_url.

Les images exposées peuvent être conservées comme références média normalisées. Le schéma de réponse actuel ne conserve ni les choix de sondage, ni les pourcentages de votes, ni les détails d’une vidéo intégrée.

Non. Il renvoie uniquement les publications publiques de la communauté et ne déploie pas les fils de commentaires qui s’y rattachent.

La chaîne peut n’avoir aucun onglet Communauté public, son fil visible peut se terminer avant results_limit, ou des publications peuvent être supprimées, réservées aux membres, privées ou soumises à une connexion.

Non. Le collecteur suit lui-même les jetons de continuation de la source pour chaque chaîne. Le curseur renvoyé par une tâche réussie ne parcourt que les enregistrements normalisés déjà sauvegardés pour cette tâche.

Chaque publication normalisée sauvegardée coûte 0,5 crédit. L’estimation initiale multiplie le results_limit par chaîne par le nombre d’URL envoyées, tandis que la facturation finale suit le nombre réel d’enregistrements sauvegardés.