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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL 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.
- Arme una lista deduplicada de URL de canales públicos o de @handle, no URL de reproducción de videos.
- Envíe la lista urls por POST a /v1/youtube/channels y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id}; queued y running son estados intermedios normales.
- 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=50Casos 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.
APIs relacionadas
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.
- YouTube Videos 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 Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Trending Videos API