youtube/
channels

Obtenga los perfiles públicos de canales de YouTube a partir de URL de canales, con identidad normalizada, descripciones, imágenes, verificación y estadísticas de audiencia visibles.

YouTube Channels API

Canales
Perfiles públicos
Métricas visibles
0.26 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 Channels

Los canales de YouTube son páginas públicas de creadores, marcas u organizaciones, con identidad, descripciones, imágenes, verificación, enlaces del perfil y los totales visibles de suscriptores, videos y vistas. Estas señales del canal sirven para investigar creadores, comparar audiencias, enriquecer directorios y analizar mercados.

Funcionalidades de la YouTube Channels API

  • Recopilación de perfiles de varios canalesRecopila los perfiles públicos de varias URL de canales en una sola solicitud.
  • Identidad de canal normalizadaDevuelve el ID del canal, el handle, el nombre visible, la URL canónica, la descripción, el avatar y el banner en una estructura consistente.
  • Métricas públicas del canalIncluye el estado de verificación, el número público de suscriptores, la cantidad de videos publicados y el total de vistas del canal.
  • Campos de contexto del perfilConserva la ubicación pública, los enlaces del perfil, la fecha de creación del canal y la URL del canal enviada.
  • Marcas de tiempo de recopilaciónAgrega collected_at a cada resultado para poder comparar los registros almacenados entre distintas fechas de recopilación.

Parámetros de la YouTube Channels API

ParámetrosObligatorioDescripción
urlsObligatorioURL públicas de canales de YouTube, separadas por comas o saltos de línea.

Cómo usar la YouTube Channels API

Convierta una lista de páginas de canales públicos en registros de identidad duraderos. La solicitud es asíncrona, así que conserve el ID de tarea hasta que se haya resuelto cada canal enviado.

  1. Arme una lista deduplicada de URL de canales públicos o de @handle, no URL de reproducción de videos.
  2. Envíe la lista urls por POST a /v1/youtube/channels y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id}; queued y running son estados intermedios normales.
  4. Cuando la tarea termine con éxito, indexe data.results.items por id y continúe con next_cursor si has_more es true.
curl -X POST "https://api.socq.ai/v1/youtube/channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casos de uso de la YouTube Channels API

  • Directorios de creadores y marcas: Enriquezca un directorio con IDs de canal estables, datos del perfil, imágenes, enlaces y métricas públicas de audiencia.
  • Calificación de creadores: Revise las descripciones de los canales, la verificación, el tamaño de la audiencia pública, la actividad de publicación y los enlaces del perfil al evaluar posibles socios.
  • Comparación de canales: Compare los suscriptores, los videos y las vistas públicos entre creadores, marcas, publicaciones o competidores.
  • Monitoreo de perfiles: Recopile los mismos canales a lo largo del tiempo para seguir los cambios en los datos públicos del perfil y en las estadísticas de audiencia.

Consejos de expertos para la YouTube Channels API

  • Almacene id como clave primaria. El handle sirve para mostrar y enrutar, pero puede cambiar sin que se cree un canal nuevo.
  • No convierta a 0 un número de suscriptores oculto. Null significa que el valor no estaba disponible públicamente, lo cual es una señal de negocio distinta.
  • Trate los enlaces de la descripción como URL externas no confiables. Valídelos y sanitícelos antes de mostrarlos en una herramienta interna.
  • Compare los contadores de audiencia solo cuando collected_at esté presente, y use una cadencia de recopilación constante para calcular tendencias.
  • Un lote exitoso puede contener menos registros que URL si un canal fue eliminado, tiene restricciones o ya no es público.
  • Combine Channels con Channel Videos o Shorts por ID de canal en lugar de repetir los campos de perfil en cada fila de contenido.

Además de la YouTube Channels 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 Comments API — Recolecta comentarios públicos, autores, interacción, videos de origen y contexto de la conversación.
  • YouTube Transcripts API — Obtiene las transcripciones disponibles en texto plano, con selección de idioma opcional.
  • YouTube Shorts API — Recolecta Shorts públicos por canal, con miniaturas, duración, datos de publicación e interacción.
  • YouTube Community Posts API — Recolecta publicaciones públicas de la pestaña Comunidad desde URLs de canales, incluyendo texto, identidad del canal, marcas de tiempo, referencias de imágenes y contexto de origen.
  • YouTube Email Finder API — Encuentra los correos comerciales públicos de la URL de un canal, con las páginas donde aparece cada dirección.

Explorar otras plataformas

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

YouTube Channels API — FAQ

YouTube Channels API obtiene los datos de perfil visibles públicamente de una o más URL de canales de YouTube. Devuelve identidad normalizada, descripciones, imágenes, verificación, estadísticas de audiencia, ubicación, enlaces del perfil y hora de recopilación.

Envíe una o más URL públicas de canales de YouTube en la lista urls. Cada canal accesible se devuelve como un resultado normalizado independiente.

Sí. Agregue varias URL de canales públicos a la misma lista urls para recopilar sus registros de perfil juntos.

Un canal puede ocultar su número de suscriptores, y los campos públicos opcionales del perfil no están presentes en todos los canales. Los valores públicos ausentes quedan vacíos en lugar de informarse como cero.

No. Este endpoint devuelve los datos de perfil del canal y estadísticas agregadas. Use Channel Videos para las subidas regulares y Shorts para los Shorts de un canal.

El uso cuesta 0.26 créditos por cada resultado de canal normalizado devuelto.