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ètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | URL 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_limit | Facultatif | Nombre 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.
- Préparez des URL complètes de chaînes YouTube publiques, avec un chemin @handle, /channel/, /c/ ou /user/.
- Envoyez urls et un results_limit de 20 à 2000 en POST à /v1/youtube/community-posts.
- Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} tant que la tâche est queued, running ou retrying.
- 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 trueCas 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.
API associées
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.
- YouTube Comments API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API