Vistear

Canales

Perfil de un canal

Cuentas, redes sociales, últimos 30 días al aire y transmisiones recientes de un canal.

GEThttps://www.vistear.com/api/v1/channels/{id}
Requiere claveCache: private, no-store

Un canal unificado con todas sus cuentas (YouTube, Kick, Twitch) y sus suscriptores, las redes y sitios que el canal publica (Instagram, X, TikTok, web…), el resumen de los últimos 30 días al aire sumando todas las cuentas, y sus transmisiones más recientes.

peak es el mayor pico horario de una de sus cuentas en esos 30 días. Para la audiencia combinada minuto a minuto usá Series por canal con mode=audience.

Autorización

Clave de API (plan Datos) o sesión Pro del sitio.

Parámetros de ruta

  • idstringobligatorio

    Id de cualquiera de sus cuentas: UC…, kick:<id> o twitch:<id>.

Parámetros de consulta

  • streamsintegerdefault: 10

    Transmisiones recientes, entre 1 y 30.

Respuesta

200 · application/json

  • id | title | categoriesstring | string[]

    El canal unificado.

  • urlstring

    Su página en Vistear.

  • thumbnail | descriptionstring | null

    Foto y descripción del canal (de su cuenta principal).

  • accountsobject[]

    Una por plataforma.

    Ver campos de accounts
    • id | platform | handle | titlestring

      La cuenta.

    • urlstring

      La cuenta en su plataforma (youtube.com, kick.com o twitch.tv).

    • thumbnailstring | null

      Foto de la cuenta.

    • subscribersnumber | null

      Suscriptores (YouTube) o suscripciones pagas (Kick).

  • linksobject[]

    Redes y sitios que publica el canal en su perfil, sin repetir sus cuentas de YouTube, Kick y Twitch. Se actualizan una vez por semana.

    Ver campos de links
    • platformstring

      instagram, twitter, tiktok, facebook, whatsapp, spotify, website…

    • label | urlstring

      Nombre para mostrar y dirección.

  • last30Daysobject

    hoursLive, daysLive, avgViewers (ponderado por minutos) y peak { viewers, at, videoId, day }.

  • recentStreamsobject[]

    videoId, channelId, title, startedAt, endedAt, isLive, peakViewers, avgViewers, minutes, likes.

Códigos de estado

  • 200El perfil.
  • 400Id inválido.
  • 401Falta la clave, es inválida o fue revocada (o la sesión del sitio venció).
  • 403La clave pertenece a un plan sin API, o la cuenta está bloqueada.
  • 429Cuota mensual agotada y sin paquetes (error quota), o más de 300 consultas en un minuto (error rate). Retry-After dice cuántos segundos esperar.
  • 404Canal no encontrado.
  • 502La base de datos no respondió. Reintentá.