youtube/
community-posts

Recopile las publicaciones de la comunidad de YouTube de URL de canales, con el texto de la publicación, la identidad del canal, marcas de tiempo, referencias a imágenes y contexto de origen en registros normalizados.

YouTube Community Posts API

Pestaña Comunidad
Entrada por URL de canal
Referencias a imágenes
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioURL 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_limitOpcionalCantidad 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.

  1. Prepare URL públicas completas de canales de YouTube con una ruta @handle, /channel/, /c/ o /user/.
  2. Envíe por POST urls y un results_limit de 20 a 2000 a /v1/youtube/community-posts.
  3. Conserve el task_id devuelto y consulte GET /v1/tasks/{task_id} mientras la tarea esté en estado queued, running o retrying.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de YouTube con datos públicos de otras plataformas sociales compatibles.

YouTube Community Posts API — FAQ

YouTube Community Posts API es una interfaz programática que recopila las publicaciones públicas de la pestaña Comunidad de URL de canales de YouTube compatibles. Devuelve IDs de publicaciones, URL, texto, identidad del canal, marcas de tiempo, referencias a imágenes y contexto del canal de origen.

Use URL completas de canales de youtube.com cuyo primer segmento de ruta sea @handle, /channel/, /c/ o /user/. Las URL de videos, publicaciones, listas de reproducción y hosts ajenos no se aceptan como entradas de canal.

results_limit tiene un valor predeterminado de 100, acepta enteros de 20 a 2000 y se aplica por separado a cada URL de canal enviada. Por lo tanto, dos canales con 100 pueden solicitar hasta 200 registros de publicaciones guardados.

Un registro puede incluir el ID y la URL de la publicación, el texto público, el ID, el handle, el nombre y la URL del canal, campos de contadores normalizados, referencias a imágenes conservadas, las horas de publicación y de recopilación, y extra.input_url.

Las imágenes expuestas pueden conservarse como referencias de medios normalizadas. El esquema de respuesta actual no conserva las opciones de las encuestas, los porcentajes de votos ni los detalles de videos incrustados.

No. Devuelve los registros públicos de las publicaciones de la comunidad y no expande los hilos de comentarios que tienen debajo.

Puede ser que el canal no tenga una pestaña Comunidad pública, que su feed visible termine antes de results_limit, o que las publicaciones estén eliminadas, sean solo para miembros, privadas o requieran iniciar sesión.

No. El recopilador sigue internamente los tokens de continuación del origen de cada canal. El cursor que devuelve una tarea exitosa solo pagina los registros normalizados ya guardados para esa tarea.

Cada publicación normalizada guardada cuesta 0.5 créditos. La estimación inicial multiplica el results_limit por canal por la cantidad de URL enviadas, mientras que la facturación final sigue la cantidad real de registros guardados.