Vistear

Series de audiencia

Series por canal

Lo mismo, por canal unificado: por video o con la audiencia combinada.

GEThttps://www.vistear.com/api/v1/profiles/series
Requiere claveCache: private, no-store

Un canal unificado agrupa las cuentas de YouTube, Kick y Twitch de un mismo programa. Cualquier id de una de sus cuentas lo identifica.

Con mode=videos devuelve una serie por transmisión de todas sus cuentas. Con mode=audience, una sola serie por canal con la audiencia sumada de todas sus plataformas.

Autorización

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

Parámetros de consulta

  • channelsstringobligatorio

    Ids de canal separados por coma, hasta 25: el UC… de YouTube, kick:<id> o twitch:<id>. Se deduplican y ordenan. También se acepta c= o el parámetro repetido.

  • rangeenumdefault: 48h

    Período hacia atrás desde ahora. El paso es de 1 minuto en 3 y 6 h, 2 minutos en 12 h, promedios de 5 y 10 minutos en 24 y 48 h, y el pico de cada hora en 7, 30 y 90 días.

    3h6h12h24h48h3d7d30d90d

  • fromstring (YYYY-MM-DD)

    Primer día de una ventana de calendario (hora de Buenos Aires). Va junto con to y reemplaza range/days.

  • tostring (YYYY-MM-DD)

    Último día de la ventana, inclusive. Hasta 90 días en total y nunca en el futuro.

  • modeenumdefault: videos

    videos: una serie por transmisión. audience: una serie por canal, sumando plataformas.

    videosaudience

  • startstring

    Inicio de un tramo exacto, ISO 8601 con zona (por ejemplo 2026-09-26T20:00:00-03:00). Va junto con end; reemplaza a range y a from/to.

  • endstring

    Fin del tramo exacto, ISO 8601 con zona: de 10 minutos a 72 horas después de start, dentro de los últimos 90 días. Los puntos son de 1 minuto hasta 12 h, 2 hasta 24 h, 5 hasta 60 h y 10 minutos después.

Respuesta

200 · application/json

  • asOfstring (ISO 8601)

    Instante de corte de los datos, en UTC.

  • t0number

    Inicio del primer punto, en milisegundos epoch (UTC).

  • stepMsnumber

    Paso entre puntos, en milisegundos. El punto i corresponde a t0 + i × stepMs.

  • nnumber

    Cantidad de puntos de cada serie.

  • hours | daysnumber

    Período cubierto: uno de los dos, según el rango pedido.

  • seriesSeries[]

    Una serie por canal (o por video).

    Ver campos de series
    • idstring

      Id del canal (o del video), estable entre consultas.

    • labelstring

      Nombre para mostrar.

    • kind"channel" | "video" | "total"

      Qué representa la serie.

    • thumbstring | null

      Imagen del canal o del video.

    • viewers(number | null)[]

      n valores alineados a la grilla. null: no había transmisión (o dato) en ese punto.

    • likes(number | null)[]

      n valores, o vacío cuando la métrica no aplica (Kick y Twitch no reportan likes).

Códigos de estado

  • 200Series de los canales pedidos.
  • 400Parámetros inválidos, un canal desconocido, o from sin to.
  • 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.
  • 502La base de datos no respondió. Reintentá.