Vistear

Series de audiencia

Series por cuenta

Audiencia de hasta 25 cuentas a la vez, hasta 90 días.

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

Devuelve una serie de espectadores (y likes, en YouTube) por cada cuenta pedida, sobre una grilla común. Es la misma consulta que usa el comparador del sitio.

Cada id es una cuenta de una plataforma. Para sumar las cuentas de un canal que transmite en varias plataformas, usá Series por canal.

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. Alias: r=, hours=3|6|12|24|48, days=7|30|90.

    3h6h12h24h48h3d7d30d90d

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 las cuentas pedidas.
  • 400Parámetros inválidos: id, rango, más de 25 canales, o from/to (este endpoint no los acepta).
  • 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á.