YouTube Community Posts
Las publicaciones de la comunidad de YouTube son novedades públicas de la pestaña Comunidad de un canal, con el texto de la publicación, la identidad del canal autor, la hora de publicación, enlaces públicos e imágenes adjuntas. Estos registros sirven para inventariar el feed de un canal, revisar anuncios y analizar la publicación entre canales.
Funcionalidades de la YouTube Community Posts API
- Recopilación por URL de varios canalesAcepta URL públicas completas de canales con rutas @handle, /channel/, /c/ o /user/ y aplica el tope de resultados elegido a cada canal de forma independiente.
- Registros de publicaciones normalizadosDevuelve los IDs públicos de las publicaciones, las URL de Comunidad, el texto, las marcas de tiempo de publicación y las de recopilación en una estructura consistente.
- Contexto del canal a la publicaciónMantiene cada publicación vinculada con el ID del canal, su handle, su nombre visible, la URL pública del canal y la URL de origen enviada.
- Referencias a imágenes adjuntasAsigna las imágenes expuestas de las publicaciones a entradas de medios normalizadas, de modo que las novedades basadas en imágenes sigan vinculadas a sus registros.
- Recorrido acotado del feedSigue las páginas de continuación del origen por canal, elimina las publicaciones duplicadas por ID o URL y se detiene en el límite elegido, al final del feed o en el tope de 100 páginas.
Parámetros de la YouTube Community Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL públicas obligatorias de canales de YouTube, separadas por comas o saltos de línea. Las rutas compatibles comienzan con @handle, /channel/, /c/ o /user/. |
results_limit | Opcional | Cantidad máxima de publicaciones de la comunidad que se recopilan por cada canal de entrada. El valor predeterminado es 100 y acepta enteros de 20 a 2000. |
Cómo usar la YouTube Community Posts API
Envíe uno o más canales públicos conocidos como una tarea asíncrona y lea los registros de publicaciones de la comunidad guardados al finalizar.
- Prepare URL públicas completas de canales de YouTube con una ruta @handle, /channel/, /c/ o /user/.
- Envíe por POST urls y un results_limit de 20 a 2000 a /v1/youtube/community-posts.
- Conserve el task_id devuelto y consulte GET /v1/tasks/{task_id} mientras la tarea esté en estado queued, running o retrying.
- Tras el éxito, lea data.results.items y pase data.results.next_cursor como cursor en la solicitud de la tarea mientras data.results.has_more sea 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 trueCasos de uso de la YouTube Community Posts API
- Inventario del feed de Comunidad de un canal: Use los IDs, las URL, el texto, las marcas de tiempo y el contexto del canal de origen de las publicaciones para armar un feed revisable de los canales públicos seleccionados.
- Revisión de anuncios y creatividades: Revise el texto de las publicaciones públicas junto con las referencias a imágenes conservadas para comparar cómo presentan los canales sus novedades fuera de los feeds de videos.
- Análisis de publicaciones entre canales: Agrupe las publicaciones normalizadas por identidad del canal y hora de publicación para comparar la actividad de la comunidad en un conjunto de canales conocido.
Consejos de expertos para la YouTube Community Posts API
- Envíe una URL de canal completa de un host de YouTube compatible; los valores de video, publicación, lista de reproducción y los que no son URL incumplen la especificación pública de entrada de canal.
- Dimensione con criterio las solicitudes de varios canales, porque results_limit se aplica a cada URL: tres canales con 20 pueden solicitar hasta 60 publicaciones guardadas.
- Trate results_limit como un tope, ya que un canal sin pestaña Comunidad pública o con un feed visible más corto puede devolver menos registros.
- Use cursor solo con GET /v1/tasks/{task_id}; la continuación del origen se gestiona internamente y no es un parámetro público de solicitud de este endpoint.
- Deduplique los registros almacenados por ID de publicación y, si no existe, por URL, y conserve extra.input_url cuando se combinen varios canales enviados.
- Revise text, media y created_at antes de usarlos en etapas posteriores; los registros normalizados actuales no conservan las opciones de encuestas ni los metadatos de videos incrustados.
APIs relacionadas
Además de la YouTube Community Posts API, use estas APIs cuando necesite otro tipo de datos públicos de YouTube.
- YouTube Channel Videos API — Recolecta videos públicos regulares desde URLs de canales, sin incluir Shorts ni transmisiones en vivo.
- YouTube Transcripts API — Obtiene las transcripciones disponibles en texto plano, con selección de idioma opcional.
- YouTube Channels API — Obtiene la identidad del canal público, imágenes, verificación y estadísticas visibles de audiencia.
- YouTube Videos API — Obtiene metadatos, miniaturas, duración e interacción desde URLs conocidas de videos o Shorts.
- YouTube Community Post API — Lee una publicación de la comunidad a partir de su enlace, con el texto completo, las imágenes adjuntas, los Me gusta y el canal que la publicó.
- YouTube Community Post Comments API — Recolecta los comentarios del enlace de una publicación de la comunidad, con los canales de quienes comentan y los conteos de Me gusta y de respuestas.
- 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